ScriptObjectModel Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Tasks.ScriptTask

Assembly:: Microsoft.SqlServer.ScriptTask.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt dem Entwickler des programmgesteuerten Skriptaufgabenzugriffs auf Objekte, die im Paket definiert sind, über das globale Dts-Objekt. Das Dts-Objekt ist eine Instanz der ScriptObjectModel Klasse.

public ref class ScriptObjectModel

public class ScriptObjectModel

type ScriptObjectModel = class

Public Class ScriptObjectModel

Vererbung: Object
ScriptObjectModel

Beispiele

Im folgenden Beispiel für die Verwendung in einer Skriptaufgabe wird die Verwendung der Eigenschaften , Eventsund TaskResult die Verwendung der VariablesEigenschaften veranschaulicht. Weitere Informationen finden Sie unter Abfragen des Active Directory mit der Skriptaufgabe.

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

Hinweise

In der Microsoft Visual Studio-Tools für Anwendungen (VSTA)-Skriptumgebung stellt die Skriptaufgabe das globale Dts Objekt bereit, das dem Entwickler programmgesteuerten Zugriff auf Objekte ermöglicht, die an anderer Stelle im Paket definiert sind, z. B. Verbindungen, Variablen und Ereignisse, über die Eigenschaften und Methoden der ScriptObjectModel Klasse. Das Dts-Objekt ist eine Instanz der ScriptObjectModel-Klasse.

Eigenschaften

Connections	Gibt die Connections-Auflistung vorhandener Verbindungen zurück, die im Paket mit dem Skripttask definiert sind.
Events	Gibt die IDTSComponentEvents-Auflistung vorhandener Ereignisse zurück, die im Paket mit dem Skripttask definiert sind.
ExecutionValue	Ruft ein benutzerdefiniertes Objekt ab, das weitere Informationen zu den Ergebnissen der Taskausführung bereitstellt, oder legt es fest.
TaskResult	Gibt DTSExecResult für den Skripttask zurück.
Transaction	Gibt die dem Container des Skripttasks zugeordnete Transaktion zurück.
VariableDispenser	Gibt den VariableDispenser zurück, der innerhalb des Skripttasks zur Bearbeitung vorhandener Variablen verwendet werden kann.
Variables	Gibt die Variables-Auflistung vorhandener Variablen zurück, die im Paket mit dem Skripttask definiert sind.

Methoden

Log(String, Int32, Byte[])

Protokolliert einen Eintrag für alle aktivierten Protokollanbieter.

Gilt für: