XMLTask Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Contient les membres utilisés pour exécuter plusieurs tâches XML, selon la OperationType propriété, qui est une valeur issue 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 IDTSComponentPersistPublic NotInheritable Class XMLTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IDTSXMLTask- Héritage
- Attributs
- Implémente
Remarques
Pour plus d’informations, voir Tâche XML.
Constructeurs
| Nom | Description |
|---|---|
| XMLTask() |
Initialise une nouvelle instance de la classe XMLTask. |
Propriétés
| Nom | Description |
|---|---|
| DebugMode |
Un booléen 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 à laquelle la tâche XML enregistre les résultats de l’opération. |
| DestinationType |
Obtient ou définit une DTSXMLSaveResultTo valeur d’énumération qui indique le type de destination vers laquelle la tâche XML sauvegarde le document XML. |
| DiffAlgorithm |
Obtient ou définit l’algorithme de comparaison à utiliser lorsque le OperationType est Diff. |
| DiffGramDestination |
Obtient ou définit le nom de la connexion ou de la variable à laquelle la tâche XML sauvegarde le document DiffGram. |
| DiffGramDestinationType |
Obtient ou définit une valeur qui indique le type de destination vers 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 un booléen qui indique si la tâche échoue si le document XML ne valide pas selon le schéma de validation. |
| FailOnValidationFail |
Obtient ou définit un booléen qui indique si l’opération échoue lorsqu’une validation échoue. |
| Namespaces |
Obtient ou définit la collection d’espaces de noms pour 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 DTSXMLOperation valeur d’énumération qui indique le type d’opération effectuée par la tâche, comme la validation ou la fusion. |
| OverwriteDestination |
Obtient ou définit un booléen qui indique si l’opération écrase les fichiers de destination existants. |
| PutResultInOneNode |
Obtient ou définit un booléen qui indique si l’opération place le résultat dans un seul nœud. |
| SaveDiffGram |
Obtient ou définit un booléen qui indique si le résultat de comparaison, un document DiffGram, est sauvegardé. |
| SaveOperationResult |
Obtient ou définit un booléen qui indique si la tâche XML sauvegarde 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 qui indique le type de source contenant le document XML, le DiffGram, le XSLT, le XPath, ou le document de validation, trouvé dans le SecondOperandfichier . |
| Source |
Obtient ou définit le nom de la connexion, de la variable ou du texte fourni par l’utilisateur qui est la source utilisée par l’opération. |
| SourceType |
Obtient ou définit une valeur de l’énumération DTSXMLSourceType qui indique le type de source contenant le document XML utilisé par l’opération. |
| SuspendRequired |
Obtient ou définit un booléen 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 d’exécution pour les tâches et conteneurs lorsqu’un point d’arrêt est rencontré. |
| TargetServerVersion |
Contient les membres utilisés pour exécuter plusieurs tâches XML, selon la OperationType propriété, qui est une valeur issue 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, selon la OperationType propriété, qui est une valeur issue de l’énumération DTSXMLOperation . Cette classe ne peut pas être héritée. |
| ValidationType |
Obtient ou définit une DTSXMLValidationType valeur d’énumération qui indique le type de validation utilisée par l’opération. |
| Version |
membre déprécié ; voir 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 DTSXMLXPathOperation valeur d’énumération 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 source contenant l’expression XPath dans la XPathStringSource propriété. |
Méthodes
| Nom | Description |
|---|---|
| AcceptBreakpointManager(BreakpointManager) |
Passe à BreakpointManager une tâche. La tâche utilisera le gestionnaire de points d’arrêt pour créer, supprimer et vérifier l’état des points d’arrêt. Cette méthode est appelée par l’exécution et n’est pas utilisée dans le code. |
| CanUpdate(String) |
membre déprécié ; voir Remarques. Un booléen qui indique si le nouveau package XML peut mettre à jour l’ancien package XML. (Hérité de Task) |
| Equals(Object) |
Détermine si deux instances d’objet sont égales. (Hérité de DtsObject) |
| Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object) |
Il 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 pour 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 l’exécution et n’est pas utilisée dans le code. |
| LoadFromXML(XmlElement, IDTSInfoEvents) |
Cette méthode n’est pas appelable par votre code d’application. Pour charger un colis enregistré en tant que .xml, utilisez la LoadPackage(String, IDTSEvents) méthode. |
| ResumeExecution() |
Reprend l’exécution de la tâche après une pause. La tâche ou le conteneur est repris par le moteur d’exécution. |
| SaveToXML(XmlDocument, IDTSInfoEvents) |
Cette méthode n’est pas appelable par votre code d’application. Pour enregistrer un paquet en tant que .xml, utilisez la SaveToXml(String, Package, IDTSEvents) méthode. |
| SuspendExecution() |
Indique que l’exécutable doit être suspendu. Cette méthode est appelée par le moteur d’exécution. |
| Update(String) |
membre déprécié ; voir Remarques. Cette méthode met à jour l’ancien package XML avec le nouveau package XML si CanUpdate(String) est réglé sur true. (Hérité de Task) |
| Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging) |
Vérifie que le composant est correctement configuré. |