ScriptObjectModel Klasse

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.

Gewährt dem Entwickler der Script-Aufgabe programmatischen Zugriff auf im Paket definierte Objekte über das globale Dts-Objekt. Das Dts-Objekt ist eine Instanz der Klasse ScriptObjectModel .

public ref class ScriptObjectModel

public class ScriptObjectModel

type ScriptObjectModel = class

Public Class ScriptObjectModel

Vererbung: Object
ScriptObjectModel

Beispiele

Das folgende Codebeispiel für die Verwendung innerhalb einer Skriptaufgabe demonstriert die Verwendung der Variables, Events, und TaskResult Eigenschaften. Weitere Informationen finden Sie unter Abfrage des Active Directory mit der Script-Aufgabe.

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

Innerhalb der Skriptumgebung Microsoft Visual Studio Tools for Applications (VSTA) stellt die Script-Aufgabe das globale Dts Objekt bereit, das dem Entwickler programmatischen Zugriff auf an anderer Stelle im Paket definierte Objekte wie Verbindungen, Variablen und Ereignisse über die Eigenschaften und Methoden der ScriptObjectModel Klasse gewährt. Das Objekt Dts ist eine Instanz der Klasse ScriptObjectModel .

Eigenschaften

Name	Beschreibung
Connections	Gibt die Connections Sammlung der bestehenden Verbindungen zurück, die im Paket definiert sind, das die Script-Aufgabe enthält.
Events	Gibt die IDTSComponentEvents Sammlung der bestehenden Ereignisse zurück, die im Paket definiert sind, das die Skript-Aufgabe enthält.
ExecutionValue	Erhält oder setzt ein benutzerdefiniertes Objekt, das zusätzliche Informationen über die Ergebnisse der Aufgabenausführung liefert.
TaskResult	Gibt die DTSExecResult Skript-Aufgabe zurück.
Transaction	Gibt die Transaktion zurück, die mit dem Container der Skriptaufgabe verknüpft ist.
VariableDispenser	Gibt das VariableDispenser zurück, das innerhalb der Script-Aufgabe verwendet werden kann, um mit bestehenden Variablen zu arbeiten.
Variables	Gibt die Variables Sammlung der vorhandenen Variablen zurück, die im Paket definiert sind, das die Skript-Aufgabe enthält.

Methoden

Name	Beschreibung
Log(String, Int32, Byte[])	Protokolliert einen Eintrag bei allen aktivierten Log-Providern.

Gilt für: