OdbcTransaction 類別

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v8.0.0

來源:

OdbcTransaction.cs

代表在資料來源進行的 SQL 異動。 此類別無法獲得繼承。

public ref class OdbcTransaction sealed : System::Data::Common::DbTransaction

public sealed class OdbcTransaction : System.Data.Common.DbTransaction

type OdbcTransaction = class
    inherit DbTransaction

Public NotInheritable Class OdbcTransaction
Inherits DbTransaction

繼承

Object

DbTransaction

OdbcTransaction

範例

下列範例會 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

備註

應用程式會在物件上OdbcConnection呼叫 BeginTransaction 來建立OdbcTransaction物件。 與交易相關聯的後續作業 (例如，認可或中止交易) 都會在 對象上 OdbcTransaction 執行。

屬性

Connection	取得與交易相關聯的 OdbcConnection 物件或 null (如果交易不再有效)。
DbConnection	當覆寫衍生類別時，取得交易相關聯的 DbConnection 物件。 (繼承來源 DbTransaction)
IsolationLevel	指定適用於此交易的 IsolationLevel。
SupportsSavepoints	取得指出這個 DbTransaction 執行個體是否支援資料庫儲存點的值。 如果為 false，方法 SaveAsync(String, CancellationToken)、RollbackAsync(String, CancellationToken) 和 ReleaseAsync(String, CancellationToken) 以及各自的同步對應項目應該會擲回 NotSupportedException。 (繼承來源 DbTransaction)

方法

Commit()	認可資料庫交易。
CommitAsync(CancellationToken)	非同步地認可資料庫交易。 (繼承來源 DbTransaction)
Dispose()	釋放 DbTransaction 使用的 Unmanaged 資源。 (繼承來源 DbTransaction)
Dispose(Boolean)	釋放 DbTransaction 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DbTransaction)
DisposeAsync()	非同步地處置交易物件。 (繼承來源 DbTransaction)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Release(String)	終結先前在目前交易中定義的儲存點。 這個動作可讓系統在交易結束前回收一些資源。 (繼承來源 DbTransaction)
ReleaseAsync(String, CancellationToken)	終結先前在目前交易中定義的儲存點。 這個動作可讓系統在交易結束前回收一些資源。 (繼承來源 DbTransaction)
Rollback()	從暫止狀態復原交易。
Rollback(String)	復原在指定儲存點建立後執行的所有命令。 (繼承來源 DbTransaction)
RollbackAsync(CancellationToken)	非同步地復原暫止狀態的交易。 (繼承來源 DbTransaction)
RollbackAsync(String, CancellationToken)	復原在指定儲存點建立後執行的所有命令。 (繼承來源 DbTransaction)
Save(String)	在交易中建立儲存點。 這個動作會將您在儲存點建立後執行的所有命令回復，並將交易狀態還原到儲存點當時的狀態。 (繼承來源 DbTransaction)
SaveAsync(String, CancellationToken)	在交易中建立儲存點。 這個動作會將您在儲存點建立後執行的所有命令回復，並將交易狀態還原到儲存點當時的狀態。 (繼承來源 DbTransaction)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• OdbcDataAdapter
• OdbcConnection
• 執行交易