ScriptObjectModel クラス

スクリプト タスクの開発者が、グローバルな Dts オブジェクトを介して、パッケージで定義されたオブジェクトにプログラムでアクセスできるようにします。Dts オブジェクトは、ScriptObjectModel クラスのインスタンスです。

名前空間:  Microsoft.SqlServer.Dts.Tasks.ScriptTask
アセンブリ:  Microsoft.SqlServer.ScriptTask (Microsoft.SqlServer.ScriptTask.dll)

構文

'宣言
Public Class ScriptObjectModel
'使用
Dim instance As ScriptObjectModel
public class ScriptObjectModel
public ref class ScriptObjectModel
type ScriptObjectModel =  class end
public class ScriptObjectModel

説明

MicrosoftVisual Studio 2008 Tools for Applications (VSTA) スクリプト環境内で、スクリプト タスクはグローバルな Dts オブジェクトを提供します。このオブジェクトにより、開発者は、パッケージ内の他の場所で定義されたオブジェクト (接続、変数、イベントなど) に、ScriptObjectModel クラスのプロパティとメソッドを介してプログラムでアクセスできるようになります。Dts オブジェクトは、ScriptObjectModel クラスのインスタンスです。

使用例

スクリプト タスク内で使用する次のサンプル コードは、VariablesEvents、および TaskResult プロパティの使用方法を示します。詳細については、「スクリプト タスクによる Active Directory へのクエリの実行」を参照してください。

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

継承階層

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

スレッド セーフ

この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。