Transaction プロパティ

スクリプト タスクのコンテナに関連付けられたトランザクションを返します。

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

構文

'宣言
Public ReadOnly Property Transaction As Object
    Get
'使用
Dim instance As ScriptObjectModel
Dim value As Object

value = instance.Transaction
public Object Transaction { get; }
public:
property Object^ Transaction {
    Object^ get ();
}
member Transaction : Object
function get Transaction () : Object

プロパティ値

型: System. . :: . .Object
スクリプト タスクのコンテナに関連付けられたトランザクションです。この値には nullNothingnullptrunitNULL 参照 (Visual Basic では Nothing) を指定できます。

説明

スクリプト タスクのコンテナに関連付けられたトランザクションを参照するには、スクリプト タスク コードで Dts オブジェクトの Transaction プロパティを使用します。接続マネージャの AcquireConnection メソッドを呼び出すときに、このトランザクション参照を渡します。

使用例

スクリプト タスク内で使用する次のサンプル コードは、スクリプト タスク内から接続マネージャにアクセスし、Transaction プロパティを使用してそれらの接続をアクティブなトランザクションに関連付ける方法を示しています。このサンプルでは、Test ADO.NET Connection という名前の ADO.NET 接続マネージャと Test Flat File Connection という名前のフラット ファイル接続マネージャを作成および構成済みであることを前提にしています。ADO.NET 接続マネージャは、データ ソースに接続するときにすぐに使用できる SqlConnection オブジェクトを返します。これに対し、フラット ファイル接続マネージャは、パスとファイル名が含まれる文字列のみを返します。フラット ファイルを開いて作業するには、System.IO 名前空間のメソッドを使用する必要があります。

Public Sub Main()

    Dim myADONETConnection As SqlClient.SqlConnection
    myADONETConnection = _
        DirectCast(Dts.Connections("Test ADO.NET Connection").AcquireConnection(Dts.Transaction), _
        SqlClient.SqlConnection)
    MsgBox(myADONETConnection.ConnectionString, _
        MsgBoxStyle.Information, "ADO.NET Connection")

    Dim myFlatFileConnection As String
    myFlatFileConnection = _
        DirectCast(Dts.Connections("Test Flat File Connection").AcquireConnection(Dts.Transaction), _
        String)
    MsgBox(myFlatFileConnection, MsgBoxStyle.Information, "Flat File Connection")

    Dts.TaskResult = ScriptResults.Success

End Sub