DTSXMLOperation Énumération

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Tasks.XMLTask

Assembly:

Microsoft.SqlServer.XMLTask.dll

Spécifie les opérations utilisées lors de l'utilisation de documents XML.

public enum class DTSXMLOperation

public enum DTSXMLOperation

type DTSXMLOperation = 

Public Enum DTSXMLOperation

Héritage

Enum

DTSXMLOperation

Champs

Diff	4	Permet de comparer deux documents XML. En utilisant le document XML source comme document de base, l'opération Diff la compare à un autre document XML, détecte les différences et écrit ces différences dans un document XML DiffGram. Cette opération inclut des propriétés permettant de personnaliser la comparaison.
Merge	3	Permet de fusionner deux documents XML. En utilisant le document XML source comme document de base, elle fusionne un deuxième document dans le document de base. Cette opération peut spécifier un emplacement de fusion dans le document.
Patch	5	Applique la sortie de l'opération Diff (un document DiffGram) à un document XML afin de créer un document parent qui peut inclure le contenu du document DiffGram.
Validate	0	Valide le document XML par rapport à une définition de type de document (DTD) ou à un schéma XSD (XML Schema definition).
XPATH	2	Lance les requêtes et les évaluations XPath.
XSLT	1	Effectue les transformations XSL sur les documents XML.

Exemples

L’exemple de code suivant montre cette énumération utilisée pour définir la OperationType droite après la création de la tâche.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.XMLTask;  

namespace XMLTask_API  
{  
    class Program  
        {  
        static void Main(string[] args)  
                {  
                        // Set up the objects and tasks.  
                        Package pkg = new Package();  
                        Executable exec1 = pkg.Executables.Add("STOCK:XMLTask");  
                        TaskHost th = exec1 as TaskHost;  
                        // You can cast the InnerObject to the XmlTask, but it is advised   
                        // that you work with tasks through the TaskHost and its Properties.  
                        // XMLTask myTask = th.InnerObject as XMLTask;  

                        // Create a variable and a FILE connection manager to books.xml.  
                        Variable resultVar = pkg.Variables.Add("resultVariable", false, "", "Variable for the result");  
                        ConnectionManager connMgr = pkg.Connections.Add("FILE");  
                        connMgr.Name = "XMLConnectionManager";  
                        // The file, Books.xml, is stored on the C:\ drive.  
                        connMgr.ConnectionString = @"c:\books.xml";  

                        // Set the XMLTask properties.  
                        // The first property to set is the OperationType. Depending on the  
                        // OperationType, different properties are valid.  
                        // The operation type in this example is VALIDATE.  
                        th.Properties["OperationType"].SetValue(th, DTSXMLOperation.Validate);  
                        th.Properties["SourceType"].SetValue(th, DTSXMLSourceType.FileConnection);  
                        th.Properties["Source"].SetValue(th, connMgr.Name);  
                        th.Properties["OverwriteDestination"].SetValue(th, true);  
                        th.Properties["SaveOperationResult"].SetValue(th, true);  
                        th.Properties["DestinationType"].SetValue(th, DTSXMLSaveResultTo.Variable);  
                        th.Properties["Destination"].SetValue(th, resultVar.Name);  
                        th.Properties["SecondOperandType"].SetValue(th, DTSXMLSourceType.DirectInput);  
                        th.Properties["SecondOperand"].SetValue(th, "<x></x>");  
                        th.Properties["ValidationType"].SetValue(th, DTSXMLValidationType.DTD);  
                        th.Properties["FailOnValidationFaile"].SetValue(th, true);  
                        DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);  
                        Console.WriteLine("RESULTS: {0}", valResults);  
                }  
        }  
}  

Exemple de sortie :

RÉSULTATS : Réussite

Remarques

Cette opération détermine les autres propriétés de la XMLTask classe valides. Par exemple, si l’opération choisie est XPATH, les propriétés PutResultInOneNode et XPathOperation sont utilisées. Lorsque l’opération est Validate, l’indicateur FailOnValidationFail est disponible. Il s’agit généralement de la première propriété définie dans le code. Vous pouvez donc voir immédiatement quelle tâche l’exécute XMLTask .