Export (0) Print
Expand All

OdbcTransaction.Commit Method

Note: This namespace, class, or member is supported only in version 1.1 of the .NET Framework.

Commits the database transaction.

[Visual Basic]
Public Overridable Sub Commit() Implements IDbTransaction.Commit
[C#]
public virtual void Commit();
[C++]
public: virtual void Commit();
[JScript]
public function Commit();

Implements

IDbTransaction.Commit

Exceptions

Exception Type Condition
Exception An error occurred while trying to commit the transaction.
InvalidOperationException The transaction has already been committed or rolled back.

-or-

The connection is broken.

Example

[Visual Basic, C#, C++] The following example creates an OdbcConnection and an OdbcTransaction. It also demonstrates how to use the BeginTransaction, Commit, and Rollback methods.

[Visual Basic] 
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()
    ' 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();
   // 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();
        // 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] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

OdbcTransaction Class | OdbcTransaction Members | System.Data.Odbc Namespace | BeginTransaction | Rollback

Show:
© 2014 Microsoft