• [アーティクル]

Destination プロパティ

XML タスクが操作の結果を保存する接続または変数の名前を取得します。値の設定も可能です。

名前空間:  Microsoft.SqlServer.Dts.Tasks.XMLTask
アセンブリ:  Microsoft.SqlServer.XMLTask (Microsoft.SqlServer.XMLTask.dll)

構文

'宣言
Public Property Destination As String
    Get
    Set
'使用
Dim instance As XMLTask
Dim value As String

value = instance.Destination

instance.Destination = value

public string Destination { get; set; }

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

abstract Destination : string with get, set
override Destination : string with get, set

final function get Destination () : String
final function set Destination (value : String)

プロパティ値

型: System. . :: . .String
XML タスクが操作の結果を保存する接続または変数の名前を表す String です。

実装

IDTSXMLTask. . :: . .Destination

説明

このプロパティは、OperationType の値に関係なく、XMLTask に対して利用できます。

使用例

次のコード例では、XMLTask をパッケージに追加し、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);
           }
        }
}

サンプル出力 :

RESULTS: Success