Udostępnij za pośrednictwem


Klasa ScriptObjectModel

Daje developer zadania skryptu programowy dostęp do obiektów zdefiniowanych w pakiet za pośrednictwem globalnego Dts obiektu.Dts obiekt jest wystąpienie ScriptObjectModel klasy

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptObjectModel

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Tasks.ScriptTask
Zestaw:  Microsoft.SqlServer.ScriptTask (w Microsoft.SqlServer.ScriptTask.dll)

Składnia

'Deklaracja
Public Class ScriptObjectModel
'Użycie
Dim instance As ScriptObjectModel
public class ScriptObjectModel
public ref class ScriptObjectModel
type ScriptObjectModel =  class end
public class ScriptObjectModel

Typ ScriptObjectModel uwidacznia następujące elementy członkowskie.

Właściwości

  Nazwa Opis
Właściwość publiczna Connections Zwraca Connections kolekcja istniejących połączeń zdefiniowanych w pakiet zawierający zadanie skryptu.
Właściwość publiczna Events Zwraca IDTSComponentEvents kolekcja istniejące zdarzenia zdefiniowane w pakiet zawierający zadanie skryptu.
Właściwość publiczna ExecutionValue Pobiera lub ustawia obiektu użytkownika, który zawiera dodatkowe informacje na temat wyniki wykonania zadania.
Właściwość publiczna TaskResult Zwraca DTSExecResult z zadań skryptu.
Właściwość publiczna Transaction Zwraca transakcji skojarzonych z kontener zadania skryptu.
Właściwość publiczna VariableDispenser Zwraca VariableDispenser , mogą być używane w ramach zadania skryptu do pracy z istniejących zmiennych.
Właściwość publiczna Variables Zwraca Variables kolekcji istniejących zmiennych zdefiniowanych w pakiet zawierający zadanie skryptu.

Do góry

Metody

  Nazwa Opis
Metoda publiczna Equals (Dziedziczony z Object).
Metoda chroniona Finalize (Dziedziczony z Object).
Metoda publiczna GetHashCode (Dziedziczony z Object).
Metoda publiczna GetType (Dziedziczony z Object).
Metoda publiczna Log Rejestruje wszystkie włączone włączeni wpis.
Metoda chroniona MemberwiseClone (Dziedziczony z Object).
Metoda publiczna ToString (Dziedziczony z Object).

Do góry

Uwagi

Within the Microsoft Visual Studio 2008 Tools for Applications (VSTA) scripting environment, the Script task provides the global Dts object, which gives the developer programmatic access to objects defined elsewhere in the package, such as connections, variables, and events, through the properties and methods of the ScriptObjectModel class.Dts obiekt jest wystąpienie ScriptObjectModel klasy

Przykłady

Poniższy przykładowy kod do użycia wewnątrz zadania skryptu zademonstrowano użycie Variables, Events, i TaskResult Właściwości.Aby uzyskać więcej informacji, zobacz temat Kwerenda usługi Active Directory z zadań skryptu.

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

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.