XMLTask Classe

Définition

Contient les membres utilisés pour exécuter plusieurs tâches XML, en fonction de la propriété OperationType, qui est une valeur de l'énumération DTSXMLOperation. Cette classe ne peut pas être héritée.

public ref class XMLTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::XMLTask::IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("BE19D629-EC49-455C-9708-27E3849F3C2A")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("935AC7BD-FEBE-4104-9E92-0D04136FFA27")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("3A8B754B-0C03-4159-88DA-E3578D25A20B")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("BE19D629-EC49-455C-9708-27E3849F3C2A")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("935AC7BD-FEBE-4104-9E92-0D04136FFA27")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("3A8B754B-0C03-4159-88DA-E3578D25A20B")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
Public NotInheritable Class XMLTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IDTSXMLTask
Héritage
Attributs
Implémente

Remarques

Pour plus d’informations, consultez Tâche XML.

Constructeurs

XMLTask()

Initialise une nouvelle instance de la classe XMLTask.

Propriétés

DebugMode

Valeur booléenne qui indique si une tâche doit vérifier si des points d’arrêt sont activés.

Destination

Obtient ou définit le nom de la connexion ou de la variable sur laquelle la tâche XML enregistre les résultats de l'opération.

DestinationType

Obtient ou définit une valeur d'énumération DTSXMLSaveResultTo qui indique le type de destination sur laquelle la tâche XML enregistre le document XML.

DiffAlgorithm

Obtient ou définit l'algorithme de comparaison à utiliser lorsque la propriété OperationType a la valeur Diff.

DiffGramDestination

Obtient ou définit le nom de la connexion ou de la variable sur laquelle la tâche XML enregistre le document DiffGram.

DiffGramDestinationType

Obtient ou définit une valeur qui indique le type de destination sur laquelle la tâche XML enregistre le document DiffGram.

DiffOptions

Obtient ou définit une valeur qui indique les options utilisées par l'opération lors de la comparaison de documents.

ExecutionValue

Retourne le résultat de l'exécution de la tâche.

FailOnDifference

Obtient ou définit une valeur booléenne qui indique si la tâche échoue si le document XML ne parvient pas à valider en fonction du schéma de validation.

FailOnValidationFail

Obtient ou définit une valeur booléenne qui indique si l’opération échoue lorsqu’une validation échoue.

Namespaces

Obtient ou définit la collection d'espaces de noms de la tâche XML.

NodeList

Obtient une classe ArrayList qui contient une collection de nœuds produits par l'opération XPath.

OperationType

Obtient ou définit une valeur d'énumération DTSXMLOperation qui indique le type d'opération effectuée par la tâche, comme une validation ou une fusion.

OverwriteDestination

Obtient ou définit une valeur booléenne qui indique si l’opération remplace les fichiers de destination existants.

PutResultInOneNode

Obtient ou définit une valeur booléenne qui indique si l’opération place le résultat dans un nœud.

SaveDiffGram

Obtient ou définit une valeur booléenne qui indique si le résultat de comparaison, un document DiffGram, est enregistré.

SaveOperationResult

Obtient ou définit une valeur booléenne qui indique si la tâche XML enregistre la sortie de l’opération Diff.

SecondOperand

Obtient ou définit le nom de la connexion, de la variable ou du texte fourni par l'utilisateur qui constitue le second opérande dans une opération utilisant deux opérandes. Le second opérande peut être un document XML, un DiffGram, un XSLT, un XPath ou un document de validation, selon l'opération.

SecondOperandType

Obtient ou définit une valeur indiquant le type de source qui contient le document XML, le DiffGram, le XSLT, le XPath ou le document de validation, figurant dans la propriété SecondOperand.

Source

Obtient ou définit le nom de la connexion, de la variable ou du texte fourni par l'utilisateur qui constitue la source utilisée par l'opération.

SourceType

Obtient ou définit une valeur de l'énumération DTSXMLSourceType indiquant le type de source qui contient le document XML utilisé par l'opération.

SuspendRequired

Obtient ou définit une valeur booléenne qui indique si les tâches doivent être suspendues lorsqu’elles rencontrent un point d’arrêt. Cette valeur est définie par le moteur du runtime pour les tâches et les conteneurs lorsqu'un point d'arrêt est rencontré.

TargetServerVersion

Contient les membres utilisés pour exécuter plusieurs tâches XML, en fonction de la propriété OperationType, qui est une valeur de l'énumération DTSXMLOperation. Cette classe ne peut pas être héritée.

(Hérité de Task)
ValidationDetails

Contient les membres utilisés pour exécuter plusieurs tâches XML, en fonction de la propriété OperationType, qui est une valeur de l'énumération DTSXMLOperation. Cette classe ne peut pas être héritée.

ValidationType

Obtient ou définit une valeur d'énumération DTSXMLValidationType qui indique le type de validation utilisé par l'opération.

Version

*** Membre déconseillé ; consultez les Remarques. *** Retourne la version de la tâche. Cette propriété est en lecture seule.

(Hérité de Task)
XPathOperation

Obtient ou définit une valeur d'énumération DTSXMLXPathOperation qui indique l'opération XPath à effectuer.

XPathStringSource

Obtient ou définit la source de l'expression XPath.

XPathStringSourceType

Obtient ou définit une valeur de l'énumération DTSXMLSourceType qui indique le type de la source contenant l'expression XPath dans la propriété XPathStringSource.

Méthodes

AcceptBreakpointManager(BreakpointManager)

Transmet un objet BreakpointManager à une tâche. La tâche utilisera le gestionnaire de points d'arrêt pour créer, supprimer des points d'arrêt et vérifier leur état. Cette méthode est appelée par le runtime et n'est pas utilisée dans le code.

CanUpdate(String)

*** Membre déconseillé ; consultez les Remarques. Valeur booléenne qui indique si le nouveau package XML peut mettre à jour l’ancien xml de package.

(Hérité de Task)
Equals(Object)

Détermine si les deux instances d'objet sont égales.

(Hérité de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Exécute la tâche.

GetConnectionID(Connections, String)

Obtient une chaîne contenant l’ID de la connexion.

(Hérité de Task)
GetConnectionName(Connections, String)

Obtient une chaîne contenant le nom de la connexion.

(Hérité de Task)
GetHashCode()

Retourne le code de hachage de cette instance.

(Hérité de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Initialise les propriétés associées à cette tâche. Cette méthode est appelée par le runtime et n'est pas utilisée dans le code.

LoadFromXML(XmlElement, IDTSInfoEvents)

Cette méthode ne peut pas être appelée par votre code d'application. Pour charger un package enregistré en tant que .xml, utilisez la méthode LoadPackage(String, IDTSEvents).

ResumeExecution()

Reprend l'exécution de la tâche après une suspension. Le moteur du runtime reprend la tâche ou le conteneur.

SaveToXML(XmlDocument, IDTSInfoEvents)

Cette méthode ne peut pas être appelée par votre code d'application. Pour enregistrer un package en tant que .xml, utilisez la méthode SaveToXml(String, Package, IDTSEvents).

SuspendExecution()

Indique que l'exécutable doit s'interrompre. Cette méthode est appelée par le moteur du runtime.

Update(String)

*** Membre déconseillé ; consultez les Remarques. Cette méthode met à jour l’ancien xml de package avec le nouveau xml de package s’il CanUpdate(String) est défini sur true.

(Hérité de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Vérifie que le composant est configuré correctement.

S’applique à