ScriptObjectModel Classe

Définition

Espace de noms:: Microsoft.SqlServer.Dts.Tasks.ScriptTask

Assembly:: Microsoft.SqlServer.ScriptTask.dll

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.

Donne au développeur de la tâche Script un accès programmatique aux objets définis dans le package via l’objet global DTS. L’objet DTS est une instance de la ScriptObjectModel classe.

public ref class ScriptObjectModel

public class ScriptObjectModel

type ScriptObjectModel = class

Public Class ScriptObjectModel

Héritage: Object
ScriptObjectModel

Exemples

L’exemple suivant de code à utiliser dans une tâche Script démontre l’utilisation des Variablespropriétés, Events, et TaskResult . Pour plus d’informations, voir Interroger l’Active Directory avec la tâche Script.

Public Sub Main()  

    Dim directory As DirectoryServices.DirectorySearcher  
    Dim result As DirectoryServices.SearchResult  
    Dim email As String  

    email = Dts.Variables("email").Value.ToString  

    Try  
        directory = New _  
            DirectoryServices.DirectorySearcher("(mail=" & email & ")")  
        result = directory.FindOne  
        Dts.Variables("name").Value = _  
            result.Properties("displayname").ToString  
        Dts.Variables("title").Value = _  
            result.Properties("title").ToString  
        Dts.TaskResult = ScriptResults.Success  
    Catch ex As Exception  
        Dts.Events.FireError(0, _  
            "Script Task Example", _  
            ex.Message & ControlChars.CrLf & ex.StackTrace, _  
            String.Empty, 0)  
        Dts.TaskResult = ScriptResults.Failure  
    End Try  

End Sub

Remarques

Dans l’environnement de script Microsoft Visual Studio Tools for Applications (VSTA), la tâche Script fournit l’objet globalDts, qui donne au développeur un accès programmatique aux objets définis ailleurs dans le package, tels que les connexions, variables et événements, via les propriétés et méthodes de la ScriptObjectModel classe. L’objet Dts est une instance de la ScriptObjectModel classe.

Propriétés

Nom	Description
Connections	Retourne la Connections collection de connexions existantes définies dans le package qui contient la tâche Script.
Events	Retourne la IDTSComponentEvents collection d’événements existants définis dans le package qui contient la tâche Script.
ExecutionValue	Obtient ou définit un objet défini par l’utilisateur qui fournit des informations supplémentaires sur les résultats de l’exécution de la tâche.
TaskResult	Retourne la DTSExecResult de la tâche Script.
Transaction	Retourne la transaction associée au conteneur de la tâche Script.
VariableDispenser	Retourne le VariableDispenser qui peut être utilisé dans la tâche Script pour travailler avec des variables existantes.
Variables	Retourne la Variables collection de variables existantes définies dans le package qui contient la tâche Script.

Méthodes

Nom	Description
Log(String, Int32, Byte[])	Enregistre une entrée à tous les fournisseurs de journaux activés.

S’applique à