TaskHost.Properties Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une collection DtsProperties qui contient les propriétés associées à la tâche.
public:
property Microsoft::SqlServer::Dts::Runtime::DtsProperties ^ Properties { Microsoft::SqlServer::Dts::Runtime::DtsProperties ^ get(); };
public Microsoft.SqlServer.Dts.Runtime.DtsProperties Properties { get; }
member this.Properties : Microsoft.SqlServer.Dts.Runtime.DtsProperties
Public ReadOnly Property Properties As DtsProperties
Valeur de propriété
Collection DtsProperties.
Implémente
Exemples
L’exemple de code suivant crée un XMLTask. À l’aide de la Properties collection, les propriétés de la tâche sont définies. L’utilisation de la Properties collection est la méthode recommandée pour définir des propriétés sur n’importe quelle tâche. Il n’est pas recommandé que la tâche soit convertie directement en sa classe et ses propriétés équivalentes.
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