TaskHost.Properties Property

Returns a DtsProperties collection that contains the properties associated with the task.

네임스페이스: Microsoft.SqlServer.Dts.Runtime
어셈블리: Microsoft.SqlServer.ManagedDTS (in microsoft.sqlserver.manageddts.dll)

구문

‘선언
Public ReadOnly Property Properties As DtsProperties

public DtsProperties Properties { get; }

public:
virtual property DtsProperties^ Properties {
    DtsProperties^ get () sealed;
}

/** @property */
public final DtsProperties get_Properties ()

public final function get Properties () : DtsProperties

속성 값

A DtsProperties collection.

예

The following code example creates an XMLTask. Using the Properties collection, the properties of the task are set. Using the Properties collection is the recommended way of setting properties on any task. It is not recommended that the task be cast to its equivalent class and properties set directly.

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 specific task,
                        // 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 using the TaskHost.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);
                }
        }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.XMLTask

Class Program
    Shared Sub Main(ByVal args() As String)
        ' Set up the objects and tasks.
        Dim pkg As New Package()
        Dim exec1 As Executable = pkg.Executables.Add("STOCK:XMLTask")
        Dim th As TaskHost = TryCast(exec1, TaskHost)
        ' You can cast the InnerObject to the specific task,
        ' 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.
        Dim resultVar As Variable = pkg.Variables.Add("resultVariable", False, "", "Variable for the result")
        Dim connMgr As ConnectionManager = 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 using the TaskHost.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)
        Dim valResults As DTSExecResult = pkg.Validate(pkg.Connections, pkg.Variables, Nothing, Nothing)
        Console.WriteLine("RESULTS: {0}", valResults)
    End Sub
End Class

스레드 보안

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 설치를 위한 하드웨어 및 소프트웨어 요구 사항을 참조하십시오.

참고 항목

참조

TaskHost Class
TaskHost Members
Microsoft.SqlServer.Dts.Runtime Namespace