OdbcTransaction クラス

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

データ ソースで作成する SQL トランザクションを表します。このクラスは継承できません。

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

System.Object
   System.MarshalByRefObject
      System.Data.Odbc.OdbcTransaction

NotInheritable Public Class OdbcTransaction
   Inherits MarshalByRefObject
   Implements IDbTransaction, IDisposable
[C#]
public sealed class OdbcTransaction : MarshalByRefObject,
   IDbTransaction, IDisposable
[C++]
public __gc __sealed class OdbcTransaction : public
   MarshalByRefObject, IDbTransaction, IDisposable
[JScript]
public class OdbcTransaction extends MarshalByRefObject implements
   IDbTransaction, IDisposable

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

アプリケーションは、 OdbcConnection オブジェクトで BeginTransaction を呼び出すことによって、 OdbcTransaction オブジェクトを作成します。トランザクションに関連付けられた後続の処理 (トランザクションのコミット、中止など) はすべて、 OdbcTransaction オブジェクトに対して実行されます。

使用例

[Visual Basic, C#, C++] OdbcConnection と OdbcTransaction を作成する例を次に示します。この例では、 BeginTransaction 、 Commit 、 Rollback の各メソッドの使い方も示します。

 
Public Sub RunOdbcTransaction(myConnString As String)
    Dim myConnection As New OdbcConnection(myConnString)
    myConnection.Open()
    
    Dim myCommand As OdbcCommand = myConnection.CreateCommand()
    Dim myTrans As OdbcTransaction
       
    ' Start a local transaction
    myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted)
    ' Assign transaction object for a pending local transaction
    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 OdbcException
     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

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

   OdbcCommand myCommand = myConnection.CreateCommand();
   OdbcTransaction myTrans;

   // Start a local transaction
   myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted);
   // Assign transaction object for a pending local transaction
   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 (OdbcException 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 RunOdbcTransaction(String* myConnString)
{
    OdbcConnection* myConnection = new OdbcConnection(myConnString);
    myConnection->Open();

    OdbcCommand* myCommand = myConnection->CreateCommand();
    OdbcTransaction* myTrans;

    // Start a local transaction
    myTrans = myConnection->BeginTransaction(IsolationLevel::ReadCommitted);
    // Assign transaction Object* for a pending local transaction
    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 (OdbcException* 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.");
    }
    myConnection->Close();
};

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

必要条件

名前空間: System.Data.Odbc

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

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

参照

OdbcTransaction メンバ | System.Data.Odbc 名前空間 | OdbcDataAdapter | OdbcConnection