OdbcConnection.BeginTransaction 方法

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v9.0.0-rc.2.24473.5

開始進行資料來源上的交易。

多載

BeginTransaction()	開始進行資料來源上的交易。
BeginTransaction(IsolationLevel)	使用指定的 IsolationLevel 值，開始進行資料來源上的交易。

BeginTransaction()

開始進行資料來源上的交易。

public:
 System::Data::Odbc::OdbcTransaction ^ BeginTransaction();

public System.Data.Odbc.OdbcTransaction BeginTransaction ();

override this.BeginTransaction : unit -> System.Data.Odbc.OdbcTransaction

Public Function BeginTransaction () As OdbcTransaction

傳回

OdbcTransaction

代表新異動的物件。

例外狀況

InvalidOperationException

交易正在作用。 不支援平行交易。

範例

下列範例會 OdbcConnection 建立 和 OdbcTransaction。 它也示範如何使用 BeginTransaction、 Commit和 Rollback 方法。

public static void ExecuteTransaction(string connectionString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand();
        OdbcTransaction transaction = null;

        // Set the Connection to the new OdbcConnection.
        command.Connection = connection;

        // Open the connection and execute the transaction.
        try
        {
            connection.Open();

            // Start a local transaction
            transaction = connection.BeginTransaction();

            // Assign transaction object for a pending local transaction.
            command.Connection = connection;
            command.Transaction = transaction;

            // Execute the commands.
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
            command.ExecuteNonQuery();
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
            command.ExecuteNonQuery();

            // Commit the transaction.
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
            try
            {
                // Attempt to roll back the transaction.
                transaction.Rollback();
            }
            catch
            {
                // Do nothing here; transaction is not active.
            }
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub ExecuteTransaction(ByVal connectionString As String)

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand()
        Dim transaction As OdbcTransaction

        ' Set the Connection to the new OdbcConnection.
        command.Connection = connection

        ' Open the connection and execute the transaction.
        Try
            connection.Open()

            ' Start a local transaction.
            transaction = connection.BeginTransaction()

            ' Assign transaction object for a pending local transaction.
            command.Connection = connection
            command.Transaction = transaction

            ' Execute the commands.
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
            command.ExecuteNonQuery()
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
            command.ExecuteNonQuery()

            ' Commit the transaction.
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")

        Catch ex As Exception
            Console.WriteLine(ex.Message)
            ' Try to rollback the transaction
            Try
                transaction.Rollback()

            Catch
                ' Do nothing here; transaction is not active.
            End Try
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

備註

若要認可或回復交易，您必須明確使用 Commit 或 Rollback 方法。

若要確定 ODBC 事務管理模型的數據提供者 .NET Framework 正確執行，請避免使用其他交易管理模型，例如數據源所提供的模型。

注意

如果您未指定隔離等級，則會由所使用的驅動程式決定隔離等級。 若要使用 BeginTransaction 方法指定隔離等級，請使用採用 參數的多 isolevel 載。

另請參閱

• 連接到資料來源

BeginTransaction(IsolationLevel)

使用指定的 IsolationLevel 值，開始進行資料來源上的交易。

public:
 System::Data::Odbc::OdbcTransaction ^ BeginTransaction(System::Data::IsolationLevel isolevel);

public System.Data.Odbc.OdbcTransaction BeginTransaction (System.Data.IsolationLevel isolevel);

override this.BeginTransaction : System.Data.IsolationLevel -> System.Data.Odbc.OdbcTransaction

Public Function BeginTransaction (isolevel As IsolationLevel) As OdbcTransaction

參數

isolevel

IsolationLevel

這個連接的交易隔離等級 (Isolation Level)。 如果您未指定隔離等級，便會使用驅動程式的預設隔離等級。

傳回

OdbcTransaction

代表新異動的物件。

例外狀況

InvalidOperationException

交易正在作用。 不支援平行交易。

範例

下列範例會 OdbcConnection 建立 和 OdbcTransaction。 它也示範如何使用 BeginTransaction、 Commit和 Rollback 方法。

public static void ExecuteTransaction(string connectionString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand();
        OdbcTransaction transaction = null;

        // Set the Connection to the new OdbcConnection.
        command.Connection = connection;

        // Open the connection and execute the transaction.
        try
        {
            connection.Open();

            // Start a local transaction
            transaction = connection.BeginTransaction();

            // Assign transaction object for a pending local transaction.
            command.Connection = connection;
            command.Transaction = transaction;

            // Execute the commands.
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
            command.ExecuteNonQuery();
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
            command.ExecuteNonQuery();

            // Commit the transaction.
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
            try
            {
                // Attempt to roll back the transaction.
                transaction.Rollback();
            }
            catch
            {
                // Do nothing here; transaction is not active.
            }
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub ExecuteTransaction(ByVal connectionString As String)

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand()
        Dim transaction As OdbcTransaction

        ' Set the Connection to the new OdbcConnection.
        command.Connection = connection

        ' Open the connection and execute the transaction.
        Try
            connection.Open()

            ' Start a local transaction.
            transaction = connection.BeginTransaction()

            ' Assign transaction object for a pending local transaction.
            command.Connection = connection
            command.Transaction = transaction

            ' Execute the commands.
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
            command.ExecuteNonQuery()
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
            command.ExecuteNonQuery()

            ' Commit the transaction.
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")

        Catch ex As Exception
            Console.WriteLine(ex.Message)
            ' Try to rollback the transaction
            Try
                transaction.Rollback()

            Catch
                ' Do nothing here; transaction is not active.
            End Try
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

備註

若要認可或回復交易，您必須明確使用 Commit 或 Rollback 方法。

若要確定 ODBC 事務管理模型的數據提供者 .NET Framework 正確執行，請避免使用其他交易管理模型，例如數據源所提供的模型。

另請參閱

• 連接到資料來源