IDbTransaction インターフェイス

[アーティクル]
03/28/2008

データソースで実行するトランザクションを示します。リレーショナルデータベースにアクセスする .NET Framework データプロバイダによって実装されます。

この型のすべてのメンバの一覧については、IDbTransaction メンバを参照してください。

System.IDisposable
System.Data.IDbTransaction

Public Interface IDbTransaction
   Inherits IDisposable
[C#]
public interface IDbTransaction : IDisposable
[C++]
public __gc __interface IDbTransaction : public IDisposable
[JScript]
public interface IDbTransaction implements IDisposable

IDbTransaction を実装するクラス

クラス	説明
OdbcTransaction	データソースで作成する SQL トランザクションを表します。このクラスは継承できません。
OleDbTransaction	データソースで作成する SQL トランザクションを表します。このクラスは継承できません。
OracleTransaction	データベースで実行するトランザクションを表します。このクラスは継承できません。
SqlCeTransaction	データソースで作成する SQL トランザクションを表します。このクラスは継承できません。
SqlTransaction	SQL Server データベースで作成する Transact-SQL トランザクションを表します。このクラスは継承できません。

解説

IDbTransaction インターフェイスによって、継承クラスはデータソースで実行するトランザクションを示す Transaction クラスを実装できます。Transaction クラスの詳細については、「トランザクションの実行」を参照してください。.NET Framework データプロバイダの実装の詳細については、「 .NET Framework データプロバイダの実装」を参照してください。

アプリケーションでは IDbTransaction インターフェイスのインスタンスは直接作成されず、 IDbTransaction を継承するクラスのインスタンスが作成されます。

IDbTransaction を継承するクラスは、継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、 IDbTransaction インターフェイスが Commit メソッドを定義します。次に、 OleDbTransaction クラスがこのプロパティを継承し、 Begin メソッドを定義します。

実装時の注意: .NET Framework データプロバイダ間に一貫性を持たせるために、継承クラスには Prv Transaction という形式の名前を付けてください。 Prv は、各 .NET Framework データプロバイダの名前空間内のすべてのクラスに付けられるプリフィックスです。たとえば、 Sql は System.Data.SqlClient 名前空間内の SqlTransaction クラスのプリフィックスです。

使用例

[Visual Basic, C#, C++] 派生クラス SqlConnection および SqlTransaction のインスタンスを作成する例を次に示します。 BeginTransaction 、 Commit 、 Rollback の各メソッドの使い方も示します。

 
Public Sub RunSqlTransaction(myConnString As String)
    Dim myConnection As New SqlConnection(myConnString)
    myConnection.Open()
    
    Dim myCommand As SqlCommand = myConnection.CreateCommand()
    Dim myTrans As SqlTransaction
    
    ' Start a local transaction
    myTrans = myConnection.BeginTransaction()
    ' Must assign both transaction object and connection
    ' to Command object for a pending local transaction
    myCommand.Connection = myConnection
    myCommand.Transaction = myTrans
    
    Try
      myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
      myCommand.ExecuteNonQuery()
      myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
      myCommand.ExecuteNonQuery()
      myTrans.Commit()
      Console.WriteLine("Both records are written to database.")
    Catch e As Exception
      Try
        myTrans.Rollback()
      Catch ex As SqlException
        If Not myTrans.Connection Is Nothing Then
          Console.WriteLine("An exception of type " & ex.GetType().ToString() & _
                            " was encountered while attempting to roll back the transaction.")
        End If
      End Try
    
      Console.WriteLine("An exception of type " & e.GetType().ToString() & _
                      "was encountered while inserting the data.")
      Console.WriteLine("Neither record was written to database.")
    Finally
      myConnection.Close()
    End Try
End Sub 'RunSqlTransaction

[C#] 
public void RunSqlTransaction(string myConnString) 
 {
    SqlConnection myConnection = new SqlConnection(myConnString);
    myConnection.Open();

    SqlCommand myCommand = myConnection.CreateCommand();
    SqlTransaction myTrans;

    // Start a local transaction
    myTrans = myConnection.BeginTransaction();
    // Must assign both transaction object and connection
    // to Command object for a pending local transaction
    myCommand.Connection = myConnection;
    myCommand.Transaction = myTrans;

    try
    {
      myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
      myCommand.ExecuteNonQuery();
      myCommand.CommandText = "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
      myCommand.ExecuteNonQuery();
      myTrans.Commit();
      Console.WriteLine("Both records are written to database.");
    }
    catch(Exception e)
    {
      try
      {
        myTrans.Rollback();
      }
      catch (SqlException ex)
      {
        if (myTrans.Connection != null)
        {
          Console.WriteLine("An exception of type " + ex.GetType() +
                            " was encountered while attempting to roll back the transaction.");
        }
      }
    
      Console.WriteLine("An exception of type " + e.GetType() +
                        " was encountered while inserting the data.");
      Console.WriteLine("Neither record was written to database.");
    }
    finally 
    {
      myConnection.Close();
    }
}

[C++] 
public:
void RunSqlTransaction(String* myConnString) 
 {
    SqlConnection* myConnection = new SqlConnection(myConnString);
    myConnection->Open();

    SqlCommand* myCommand = myConnection->CreateCommand();
    SqlTransaction* myTrans;

    // Start a local transaction
    myTrans = myConnection->BeginTransaction();
    // Must assign both transaction object and connection
    // to Command object for a pending local transaction
    myCommand->Connection = myConnection;
    myCommand->Transaction = myTrans;

    try
    {
      myCommand->CommandText = S"Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
      myCommand->ExecuteNonQuery();
      myCommand->CommandText = S"Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
      myCommand->ExecuteNonQuery();
      myTrans->Commit();
      Console::WriteLine(S"Both records are written to database.");
    }
    catch(Exception* e)
    {
      try
      {
        myTrans->Rollback();
      }
      catch (SqlException* ex)
      {
        if (myTrans->Connection != 0)
        {
          Console::WriteLine(S"An exception of type {0} was encountered while attempting to roll back the transaction.", ex->GetType());
        }
      }
    
      Console::WriteLine(S"An exception of type {0} was encountered while inserting the data.", e->GetType());
      Console::WriteLine(S"Neither record was written to database.");
    }
    __finally 
    {
      myConnection->Close();
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Data

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Data (System.Data.dll 内)

参照

IDbTransaction メンバ | System.Data 名前空間

次の方法で共有

IDbTransaction インターフェイス

IDbTransaction を実装するクラス

解説

使用例

必要条件

参照

その他のリソース