TransactionScope

.NET Framework クラス ライブラリ リファレンス

TransactionScope クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

コード ブロックをトランザクションにします。このクラスは継承できません。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 TransactionScope
    Implements IDisposable

Visual Basic (使用法)

Dim instance As TransactionScope

C#

public sealed class TransactionScope : IDisposable

C++

public ref class TransactionScope sealed :
 IDisposable

J#

public final class TransactionScope implements
 IDisposable

JScript

public final class TransactionScope implements
 IDisposable

解説

System.Transactions インフラストラクチャは、Transaction クラスに基づく明示的なプログラミング モデルだけでなく、インフラストラクチャがトランザクションを自動的に管理する、TransactionScope クラスを使用した暗黙のプログラミング モデルも提供します。

重要 :
TransactionScope クラスを使用して暗黙のトランザクションを作成し、アンビエント トランザクション コンテキストを自動的に管理することをお勧めします。複数の関数呼び出しまたは複数のスレッド呼び出しで同じトランザクションを使用する必要のあるアプリケーション向けに、TransactionScope クラスおよび DependentTransaction クラスを使用する必要もあります。このモデルの詳細については、「トランザクション スコープを使用した暗黙的なトランザクションの実装」を参照してください。トランザクション アプリケーションの記述の詳細については、「トランザクション アプリケーションの作成」を参照してください。

new ステートメントで TransactionScope をインスタンス化すると、トランザクション マネージャによって参加するトランザクションが決定されます。いったん決定されると、このスコープは常にそのトランザクションに参加します。この決定は 2 つの要因に基づいて行われます。1 つはアンビエント トランザクションが存在するかどうか、もう 1 つはコンストラクタの TransactionScopeOption パラメータの値です。アンビエント トランザクションとは、その中でコードが実行されるトランザクションです。Transaction クラスの静的 Current プロパティを呼び出すことによってアンビエント トランザクションへの参照を取得できます。このパラメータの使用方法の詳細については、「トランザクション スコープを使用した暗黙的なトランザクションの実装」で、トランザクション フローの管理についての説明を参照してください。

トランザクション スコープ内 (つまり、TransactionScope オブジェクトの初期化からその Dispose メソッドの呼び出しまでの間) で例外が発生しなかった場合、スコープが参加しているトランザクションを続行できます。トランザクション スコープ内で例外が発生した場合、スコープが参加しているトランザクションはロールバックされます。

アプリケーションがトランザクション内で実行する必要のあるすべての作業を完了したら、トランザクション マネージャにトランザクションをコミットできることを知らせるために、Complete メソッドを一度だけ呼び出す必要があります。このメソッドを呼び出さないと、トランザクションが中止されます。

Dispose メソッドの呼び出しによって、トランザクション スコープの末尾がマークされます。このメソッドの呼び出し後に発生した例外は、トランザクションに影響しない場合があります。

スコープ内で Current の値を変更すると、Dispose を呼び出したときに例外がスローされます。ただし、スコープの末尾では以前の値が復元されます。また、トランザクションを作成したトランザクション スコープ内のCurrent で Dispose を呼び出した場合、このトランザクションはスコープの末尾で中止されます。

使用例

次の例では、TransactionScope クラスを使用してトランザクションに参加するコード ブロックを定義する方法を示します。

Visual Basic

'  This function takes arguments for 2 connection strings and commands
 to create a transaction 
'  involving two SQL Servers. It returns a value > 0 if the transaction
 is committed, 0 if the 
'  transaction is rolled back. To test this code, you can connect to
 two different databases 
'  on the same server by altering the connection string, or to another
 RDBMS such as Oracle 
'  by altering the code in the connection2 code block.
Public Function CreateTransactionScope( _
  ByVal connectString1 As String,
 ByVal connectString2 As String,
 _
  ByVal commandText1 As String,
 ByVal commandText2 As String)
 As Integer

    ' Initialize the return value to zero and create a StringWriter
 to display results.
    Dim returnValue As Integer
 = 0
    Dim writer As System.IO.StringWriter =
 New System.IO.StringWriter

    ' Create the TransactionScope to execute the commands, guaranteeing
    '  that both commands can commit or roll back as a single unit of
 work.
    Using scope As New TransactionScope()
        Using connection1 As New SqlConnection(connectString1)
            Try
                ' Opening the connection automatically enlists it in
 the 
                ' TransactionScope as a lightweight transaction.
                connection1.Open()

                ' Create the SqlCommand object and execute the first
 command.
                Dim command1 As SqlCommand
 = New SqlCommand(commandText1, connection1)
                returnValue = command1.ExecuteNonQuery()
                writer.WriteLine("Rows to be affected by command1:
 {0}", returnValue)

                ' If you get here, this means that command1 succeeded.
 By nesting
                ' the using block for connection2 inside that of connection1,
 you
                ' conserve server and network resources as connection2
 is opened
                ' only when there is a chance that the transaction can
 commit.   
                 Using connection2 As New SqlConnection(connectString2)
                    Try
                        ' The transaction is escalated to a full distributed
                        ' transaction when connection2 is opened.
                        connection2.Open()

                        ' Execute the second command in the second database.
                        returnValue = 0
                        Dim command2 As SqlCommand
 = New SqlCommand(commandText2, connection2)
                        returnValue = command2.ExecuteNonQuery()
                        writer.WriteLine("Rows to be affected
 by command2: {0}", returnValue)

                    Catch ex As Exception
                        ' Display information that command2 failed.
                        writer.WriteLine("returnValue for command2:
 {0}", returnValue)
                        writer.WriteLine("Exception Message2:
 {0}", ex.Message)
                    End Try
                End Using

            Catch ex As Exception
                ' Display information that command1 failed.
                writer.WriteLine("returnValue for command1: {0}",
 returnValue)
                writer.WriteLine("Exception Message1: {0}",
 ex.Message)
            End Try
        End Using

        ' The Complete method commits the transaction. If an exception
 has been thrown,
        ' Complete is called and the transaction is rolled back.
        scope.Complete()
    End Using

    ' The returnValue is greater than 0 if the transaction committed.
    If returnValue > 0 Then
        writer.WriteLine("Transaction was committed.")
    Else
       ' You could write additional business logic here, for example,
 you can notify the caller 
       ' by throwing a TransactionAbortedException, or logging the failure.
       writer.WriteLine("Transaction rolled back.")
     End If

    ' Display messages.
    Console.WriteLine(writer.ToString())

    Return returnValue
End Function

C#

// This function takes arguments for 2 connection strings and commands
 to create a transaction 
// involving two SQL Servers. It returns a value > 0 if the transaction
 is committed, 0 if the 
// transaction is rolled back. To test this code, you can connect to
 two different databases 
// on the same server by altering the connection string, or to another
 RDBMS such as Oracle 
// by altering the code in the connection2 code block.
static public int CreateTransactionScope(
    string connectString1, string connectString2
,
    string commandText1, string commandText2)
{
    // Initialize the return value to zero and create a StringWriter
 to display results.
    int returnValue = 0;
    System.IO.StringWriter writer = new System.IO.StringWriter();

    // Create the TransactionScope to execute the commands, guaranteeing
    // that both commands can commit or roll back as a single unit of
 work.
    using (TransactionScope scope = new TransactionScope())
    {
        using (SqlConnection connection1 = new
 SqlConnection(connectString1))
        {
            try
            {
                // Opening the connection automatically enlists it in
 the 
                // TransactionScope as a lightweight transaction.
                connection1.Open();

                // Create the SqlCommand object and execute the first
 command.
                SqlCommand command1 = new SqlCommand(commandText1,
 connection1);
                returnValue = command1.ExecuteNonQuery();
                writer.WriteLine("Rows to be affected by command1: {0}",
 returnValue);

                // If you get here, this means that command1 succeeded.
 By nesting
                // the using block for connection2 inside that of connection1,
 you
                // conserve server and network resources as connection2
 is opened
                // only when there is a chance that the transaction
 can commit.   
                using (SqlConnection connection2 = new
 SqlConnection(connectString2))
                    try
                    {
                        // The transaction is escalated to a full distributed
                        // transaction when connection2 is opened.
                        connection2.Open();

                        // Execute the second command in the second
 database.
                        returnValue = 0;
                        SqlCommand command2 = new SqlCommand(commandText2,
 connection2);
                        returnValue = command2.ExecuteNonQuery();
                        writer.WriteLine("Rows to be affected by command2: {0}",
 returnValue);
                    }
                    catch (Exception ex)
                    {
                        // Display information that command2 failed.
                        writer.WriteLine("returnValue for
 command2: {0}", returnValue);
                        writer.WriteLine("Exception Message2: {0}", ex.Message);
                    }
            }
            catch (Exception ex)
            {
                // Display information that command1 failed.
                writer.WriteLine("returnValue for command1:
 {0}", returnValue);
                writer.WriteLine("Exception Message1: {0}", ex.Message);
            }
        }

        // The Complete method commits the transaction. If an exception
 has been thrown,
        // Complete is not  called and the transaction is rolled back.
        scope.Complete();
    }

    // The returnValue is greater than 0 if the transaction committed.
    if (returnValue > 0)
    {
        writer.WriteLine("Transaction was committed.");
    }
    else
    {
        // You could write additional business logic here, for example,
 you can notify the caller 
        // by throwing a TransactionAbortedException, or logging the
 failure.
        writer.WriteLine("Transaction rolled back.");
    }

    // Display messages.
    Console.WriteLine(writer.ToString());

    return returnValue;
}

継承階層

System.Object
  System.Transactions.TransactionScope

スレッド セーフ

この型は、マルチスレッド操作に対して安全です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

TransactionScope クラスの新しいインスタンスを初期化します。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New TransactionScope

C#

public TransactionScope ()

C++

public:
TransactionScope ()

J#

public TransactionScope ()

JScript

public function TransactionScope ()

解説

このコンストラクタは、Required と等しいトランザクション スコープ オプションを使用して新しいトランザクション スコープを作成します。つまり、新しいスコープはトランザクションを必要としますが、既にトランザクションが存在する場合はアンビエント トランザクションが使用されます。トランザクションが存在しない場合は、スコープに入る前に新しいトランザクションが作成されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (TransactionScopeOption, TimeSpan)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

タイムアウト値と要件を指定して、TransactionScope クラスの新しいインスタンスを初期化します。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scopeOption As TransactionScopeOption, _
    scopeTimeout As TimeSpan _
)

Visual Basic (使用法)

Dim scopeOption As TransactionScopeOption
Dim scopeTimeout As TimeSpan

Dim instance As New TransactionScope(scopeOption,
 scopeTimeout)

C#

public TransactionScope (
    TransactionScopeOption scopeOption,
    TimeSpan scopeTimeout
)

C++

public:
TransactionScope (
    TransactionScopeOption scopeOption, 
    TimeSpan scopeTimeout
)

J#

public TransactionScope (
    TransactionScopeOption scopeOption, 
    TimeSpan scopeTimeout
)

JScript

public function TransactionScope (
    scopeOption : TransactionScopeOption, 
    scopeTimeout : TimeSpan
)

パラメータ

scopeOption

このトランザクション スコープに関連付けられているトランザクション要件を示す TransactionScopeOption 列挙体のインスタンス。

scopeTimeout

トランザクション スコープがタイムアウトしてトランザクションが中止されるまでの TimeSpan。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (TransactionScopeOption)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

要件を指定して、TransactionScope クラスの新しいインスタンスを初期化します。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scopeOption As TransactionScopeOption _
)

Visual Basic (使用法)

Dim scopeOption As TransactionScopeOption

Dim instance As New TransactionScope(scopeOption)

C#

public TransactionScope (
    TransactionScopeOption scopeOption
)

C++

public:
TransactionScope (
    TransactionScopeOption scopeOption
)

J#

public TransactionScope (
    TransactionScopeOption scopeOption
)

JScript

public function TransactionScope (
    scopeOption : TransactionScopeOption
)

パラメータ

scopeOption

このトランザクション スコープに関連付けられているトランザクション要件を示す TransactionScopeOption 列挙体のインスタンス。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (Transaction)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

TransactionScope クラスの新しいインスタンスを初期化し、指定したトランザクションをアンビエント トランザクションとして設定します。これによって、スコープ内で実行されるトランザクション作業でこのトランザクションが使用されます。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    transactionToUse As Transaction _
)

Visual Basic (使用法)

Dim transactionToUse As Transaction

Dim instance As New TransactionScope(transactionToUse)

C#

public TransactionScope (
    Transaction transactionToUse
)

C++

public:
TransactionScope (
    Transaction^ transactionToUse
)

J#

public TransactionScope (
    Transaction transactionToUse
)

JScript

public function TransactionScope (
    transactionToUse : Transaction
)

パラメータ

transactionToUse

スコープ内で実行されるトランザクション作業でこのトランザクションが使用されるように、アンビエント トランザクションとして設定するトランザクション。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (Transaction, TimeSpan)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

タイムアウト値を指定して TransactionScope クラスの新しいインスタンスを初期化し、指定したトランザクションをアンビエント トランザクションとして設定します。これによって、スコープ内で実行されるトランザクション作業でこのトランザクションが使用されます。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    transactionToUse As Transaction, _
    scopeTimeout As TimeSpan _
)

Visual Basic (使用法)

Dim transactionToUse As Transaction
Dim scopeTimeout As TimeSpan

Dim instance As New TransactionScope(transactionToUse,
 scopeTimeout)

C#

public TransactionScope (
    Transaction transactionToUse,
    TimeSpan scopeTimeout
)

C++

public:
TransactionScope (
    Transaction^ transactionToUse, 
    TimeSpan scopeTimeout
)

J#

public TransactionScope (
    Transaction transactionToUse, 
    TimeSpan scopeTimeout
)

JScript

public function TransactionScope (
    transactionToUse : Transaction, 
    scopeTimeout : TimeSpan
)

パラメータ

transactionToUse

スコープ内で実行されるトランザクション作業でこのトランザクションが使用されるように、アンビエント トランザクションとして設定するトランザクション。

scopeTimeout

トランザクション スコープがタイムアウトしてトランザクションが中止されるまでの TimeSpan。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (TransactionScopeOption, TransactionOptions)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

要件を指定して、TransactionScope クラスの新しいインスタンスを初期化します。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scopeOption As TransactionScopeOption, _
    transactionOptions As TransactionOptions _
)

Visual Basic (使用法)

Dim scopeOption As TransactionScopeOption
Dim transactionOptions As TransactionOptions

Dim instance As New TransactionScope(scopeOption,
 transactionOptions)

C#

public TransactionScope (
    TransactionScopeOption scopeOption,
    TransactionOptions transactionOptions
)

C++

public:
TransactionScope (
    TransactionScopeOption scopeOption, 
    TransactionOptions transactionOptions
)

J#

public TransactionScope (
    TransactionScopeOption scopeOption, 
    TransactionOptions transactionOptions
)

JScript

public function TransactionScope (
    scopeOption : TransactionScopeOption, 
    transactionOptions : TransactionOptions
)

パラメータ

scopeOption

このトランザクション スコープに関連付けられているトランザクション要件を示す TransactionScopeOption 列挙体のインスタンス。

transactionOptions

新しいトランザクションが作成された場合に使用するトランザクション オプションを示す TransactionOptions 構造体。既存のトランザクションを使用する場合は、このパラメータのタイムアウト値がトランザクション スコープに適用されます。スコープを破棄する前にその時間が経過してしまうと、トランザクションは中止されます。

解説

transactionOptions パラメータを使用して IsolationLevel を指定し、このスコープで後からトランザクションを作成する場合、新しいトランザクションは指定した分離レベルに関連付けられます。分離レベルをトランザクションと共に渡した場合、トランザクションの分離レベルが同じになるか、例外がスローされます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (Transaction, TimeSpan, EnterpriseServicesInteropOption)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

タイムアウト値と COM+ 相互運用性要件を指定して TransactionScope クラスの新しいインスタンスを初期化し、指定したトランザクションをアンビエント トランザクションとして設定します。これによって、スコープ内で実行されるトランザクション作業でこのトランザクションが使用されます。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    transactionToUse As Transaction, _
    scopeTimeout As TimeSpan, _
    interopOption As EnterpriseServicesInteropOption _
)

Visual Basic (使用法)

Dim transactionToUse As Transaction
Dim scopeTimeout As TimeSpan
Dim interopOption As EnterpriseServicesInteropOption

Dim instance As New TransactionScope(transactionToUse,
 scopeTimeout, interopOption)

C#

public TransactionScope (
    Transaction transactionToUse,
    TimeSpan scopeTimeout,
    EnterpriseServicesInteropOption interopOption
)

C++

public:
TransactionScope (
    Transaction^ transactionToUse, 
    TimeSpan scopeTimeout, 
    EnterpriseServicesInteropOption interopOption
)

J#

public TransactionScope (
    Transaction transactionToUse, 
    TimeSpan scopeTimeout, 
    EnterpriseServicesInteropOption interopOption
)

JScript

public function TransactionScope (
    transactionToUse : Transaction, 
    scopeTimeout : TimeSpan, 
    interopOption : EnterpriseServicesInteropOption
)

パラメータ

transactionToUse

スコープ内で実行されるトランザクション作業でこのトランザクションが使用されるように、アンビエント トランザクションとして設定するトランザクション。

scopeTimeout

トランザクション スコープがタイムアウトしてトランザクションが中止されるまでの TimeSpan。

interopOption

関連付けられているトランザクションが COM+ トランザクションとやり取りする方法を示す EnterpriseServicesInteropOption 列挙体のインスタンス。

解説

メモ   このメソッドは、LinkDemand を使用して信頼関係のないコードからの呼び出しを防ぎます。ただし、FullTrust アクセス許可セットを保持する必要があるのは、直前の呼び出し元だけです。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ (TransactionScopeOption, TransactionOptions, EnterpriseServicesInteropOption)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

スコープ、COM+ 相互運用性要件、およびトランザクション オプションを指定して、TransactionScope クラスの新しいインスタンスを初期化します。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scopeOption As TransactionScopeOption, _
    transactionOptions As TransactionOptions, _
    interopOption As EnterpriseServicesInteropOption _
)

Visual Basic (使用法)

Dim scopeOption As TransactionScopeOption
Dim transactionOptions As TransactionOptions
Dim interopOption As EnterpriseServicesInteropOption

Dim instance As New TransactionScope(scopeOption,
 transactionOptions, interopOption)

C#

public TransactionScope (
    TransactionScopeOption scopeOption,
    TransactionOptions transactionOptions,
    EnterpriseServicesInteropOption interopOption
)

C++

public:
TransactionScope (
    TransactionScopeOption scopeOption, 
    TransactionOptions transactionOptions, 
    EnterpriseServicesInteropOption interopOption
)

J#

public TransactionScope (
    TransactionScopeOption scopeOption, 
    TransactionOptions transactionOptions, 
    EnterpriseServicesInteropOption interopOption
)

JScript

public function TransactionScope (
    scopeOption : TransactionScopeOption, 
    transactionOptions : TransactionOptions, 
    interopOption : EnterpriseServicesInteropOption
)

パラメータ

scopeOption

このトランザクション スコープに関連付けられているトランザクション要件を示す TransactionScopeOption 列挙体のインスタンス。

transactionOptions

新しいトランザクションが作成された場合に使用するトランザクション オプションを示す TransactionOptions 構造体。既存のトランザクションを使用する場合は、このパラメータのタイムアウト値がトランザクション スコープに適用されます。スコープを破棄する前にその時間が経過してしまうと、トランザクションは中止されます。

interopOption

関連付けられているトランザクションが COM+ トランザクションとやり取りする方法を示す EnterpriseServicesInteropOption 列挙体のインスタンス。

解説

transactionOptions パラメータを使用して IsolationLevel を指定し、このスコープで後からトランザクションを作成する場合、新しいトランザクションは指定した分離レベルに関連付けられます。分離レベルをトランザクションと共に渡した場合、トランザクションの分離レベルが同じになるか、例外がスローされます。

メモ   このメソッドは、LinkDemand を使用して信頼関係のないコードからの呼び出しを防ぎます。ただし、FullTrust アクセス許可セットを保持する必要があるのは、直前の呼び出し元だけです。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope コンストラクタ

TransactionScope クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
TransactionScope ()	TransactionScope クラスの新しいインスタンスを初期化します。
TransactionScope (Transaction)	TransactionScope クラスの新しいインスタンスを初期化し、指定したトランザクションをアンビエント トランザクションとして設定します。これによって、スコープ内で実行されるトランザクション作業でこのトランザクションが使用されます。
TransactionScope (TransactionScopeOption)	要件を指定して、TransactionScope クラスの新しいインスタンスを初期化します。
TransactionScope (Transaction, TimeSpan)	タイムアウト値を指定して TransactionScope クラスの新しいインスタンスを初期化し、指定したトランザクションをアンビエント トランザクションとして設定します。これによって、スコープ内で実行されるトランザクション作業でこのトランザクションが使用されます。
TransactionScope (TransactionScopeOption, TimeSpan)	タイムアウト値と要件を指定して、TransactionScope クラスの新しいインスタンスを初期化します。
TransactionScope (TransactionScopeOption, TransactionOptions)	要件を指定して、TransactionScope クラスの新しいインスタンスを初期化します。
TransactionScope (Transaction, TimeSpan, EnterpriseServicesInteropOption)	タイムアウト値と COM+ 相互運用性要件を指定して TransactionScope クラスの新しいインスタンスを初期化し、指定したトランザクションをアンビエント トランザクションとして設定します。これによって、スコープ内で実行されるトランザクション作業でこのトランザクションが使用されます。
TransactionScope (TransactionScopeOption, TransactionOptions, EnterpriseServicesInteropOption)	スコープ、COM+ 相互運用性要件、およびトランザクション オプションを指定して、TransactionScope クラスの新しいインスタンスを初期化します。

参照

関連項目

TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Complete	スコープ内のすべての操作が正常に完了したことを示します。
	Dispose	トランザクション スコープを終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

TransactionScope クラス
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装

TransactionScope メンバ

コード ブロックをトランザクションにします。このクラスは継承できません。

TransactionScope データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	TransactionScope	オーバーロードされます。 TransactionScope クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Complete	スコープ内のすべての操作が正常に完了したことを示します。
	Dispose	トランザクション スコープを終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

TransactionScope クラス
System.Transactions 名前空間

その他の技術情報

トランザクション スコープを使用した暗黙的なトランザクションの実装