DTSXMLOperation Перечисление

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Tasks.XMLTask

Сборка:

Microsoft.SqlServer.XMLTask.dll

Указывает операции, используемые при работе с XML-документами.

public enum class DTSXMLOperation

public enum DTSXMLOperation

type DTSXMLOperation = 

Public Enum DTSXMLOperation

Наследование

Enum

DTSXMLOperation

Поля

Имя	Значение	Описание
Validate	0	Проверяет XML-документ по определению типа документа (DTD) или определению схемы XML (XSD).
XSLT	1	Выполняет преобразование XSL в XML-документах.
XPATH	2	Выполняет запросы и вычисления XPath.
Merge	3	Выполняет слияние двух XML-документов. Используя исходный XML-документ в качестве базового, он объединяет второй документ с базовым документом. Операция может указать место слияния в документе.
Diff	4	Сравнивает два XML-документа. Используя исходный XML-документ в качестве базового документа, операция Diff сравнивает его с другим XML-документом, обнаруживает различия и затем записывает различия в XML-документ DiffGram. Эта операция содержит свойства для настройки сравнения.
Patch	5	Применяет выход операции Diff (документ DiffGram) к XML-документу для создания нового родительского документа, который может включать содержимое из документа DiffGram.

Примеры

Следующий пример кода показывает, что это перечисление используется для установки правого значения OperationType после создания задачи.

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);  
                }  
        }  
}  

Пример вывода:

РЕЗУЛЬТАТЫ: Успех

Комментарии

Эта операция определяет, какие другие свойства XMLTask класса допустимы. Например, если выбранная операция — XPATH, то свойства PutResultInOneNode и XPathOperation используются. Когда операция — Validate, то FailOnValidationFail доступен флаг. Обычно это первое свойство, заданное в коде, чтобы сразу видеть, какую задачу выполняется XMLTask .