OdbcConnection.BeginTransaction メソッド (IsolationLevel)

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

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

指定した IsolationLevel 値を使用して、データソースでトランザクションを開始します。

Overloads Public Function BeginTransaction( _
   ByVal isolevel As IsolationLevel _) As OdbcTransaction
[C#]
public OdbcTransaction BeginTransaction(IsolationLevelisolevel);
[C++]
public: OdbcTransaction* BeginTransaction(IsolationLevelisolevel);
[JScript]
public function BeginTransaction(
   isolevel : IsolationLevel) : OdbcTransaction;

パラメータ

isolevel
この接続のトランザクション分離レベル。分離レベルを指定しない場合、ドライバの既定の分離レベルが使用されます。

戻り値

新しいトランザクションを表すオブジェクト。

例外

例外の種類	条件
InvalidOperationException	トランザクションは、現在アクティブです。並列トランザクションはサポートされていません。

解説

トランザクションをコミットまたはロールバックするには、明示的に Commit メソッドまたは Rollback メソッドを使用する必要があります。

.NET Framework Data Provider for ODBC のトランザクション管理モデルを正しく実行するために、データソースが提供するモデルなどの他のトランザクション管理モデルは使用しないでください。

使用例

[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++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

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

参照

次の方法で共有

OdbcConnection.BeginTransaction メソッド (IsolationLevel)

パラメータ

戻り値

例外

解説

使用例

必要条件

参照

その他のリソース