ScriptObjectModel Classe

Référence

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 de script l’accès par programme aux objets définis dans le package via l’objet Dts global. 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 de code suivant à utiliser à l’intérieur d’une tâche de script illustre l’utilisation des propriétés et TaskResult des Variables Eventspropriétés. Pour plus d’informations, consultez Interroger Active Directory avec la tâche de 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 VSTA (Microsoft® Visual Studio® Tools for Applications), la tâche script fournit l’objet globalDts, qui permet au développeur d’accéder par programme aux objets définis ailleurs dans le package, tels que les connexions, les variables et les événements, par le biais des propriétés et des méthodes de la ScriptObjectModel classe. L'objet Dts est une instance de la classe ScriptObjectModel.

Propriétés

Connections	Retourne la collection Connections des connexions existantes, définies dans le package qui contient la tâche de script.
Events	Retourne la collection IDTSComponentEvents des événements existants, définis dans le package qui contient la tâche de 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 des tâches.
TaskResult	Retourne l'objet DTSExecResult de la tâche de script.
Transaction	Retourne la transaction associée au conteneur de la tâche de script.
VariableDispenser	Retourne l'objet VariableDispenser qui peut être utilisé dans la tâche de script pour travailler avec des variables existantes.
Variables	Retourne la collection Variables des variables existantes, définies dans le package qui contient la tâche de script.

Méthodes

Log(String, Int32, Byte[])

Enregistre une entrée de journal dans tous les modules fournisseurs d'informations activés.

S’applique à