XMLTask.Destination Property

Gets or sets the name of the connection or the variable to which the XML task saves the results of the operation.

命名空间: Microsoft.SqlServer.Dts.Tasks.XMLTask
程序集: Microsoft.SqlServer.XMLTask (in microsoft.sqlserver.xmltask.dll)

语法

声明
Public Property Destination As String

public string Destination { get; set; }

public:
virtual property String^ Destination {
    String^ get () sealed;
    void set (String^ value) sealed;
}

/** @property */
public final String get_Destination ()

/** @property */
public final void set_Destination (String value)

public final function get Destination () : String

public final function set Destination (value : String)

属性值

A String that contains the name of the connection or variable to which the XML task saves the results of the operation.

备注

This property is available to the XMLTask, regardless of the OperationType value.

示例

The following code example adds an XMLTask to a package, and sets properties using the TaskHost.

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 here.
                // 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 C:\ drive.
                connMgr.ConnectionString = @"c:\books.xml";

                // Set the XMLTask properties.
                // The first property to set is OperationType.
                // Depending on the OperationType, 
                // different properties are valid.
                // The OperationType 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);
           }
        }
}

Sample Output:

RESULTS: Success

线程安全

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

平台

开发平台

有关支持的平台列表，请参阅安装 SQL Server 2005 的硬件和软件要求。

目标平台

有关支持的平台列表，请参阅安装 SQL Server 2005 的硬件和软件要求。

请参阅

参考

XMLTask Class
XMLTask Members
Microsoft.SqlServer.Dts.Tasks.XMLTask Namespace