OdbcTransaction 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表在資料來源進行的 SQL 異動。 此類別無法獲得繼承。
public ref class OdbcTransaction sealed : System::Data::Common::DbTransaction
public ref class OdbcTransaction sealed : MarshalByRefObject, IDisposable, System::Data::IDbTransaction
public sealed class OdbcTransaction : System.Data.Common.DbTransaction
public sealed class OdbcTransaction : MarshalByRefObject, IDisposable, System.Data.IDbTransaction
type OdbcTransaction = class
inherit DbTransaction
type OdbcTransaction = class
inherit MarshalByRefObject
interface IDbTransaction
interface IDisposable
Public NotInheritable Class OdbcTransaction
Inherits DbTransaction
Public NotInheritable Class OdbcTransaction
Inherits MarshalByRefObject
Implements IDbTransaction, IDisposable
- 繼承
- 繼承
- 實作
範例
下列範例會 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 物件或 |
DbConnection |
當覆寫衍生類別時,取得交易相關聯的 DbConnection 物件。 (繼承來源 DbTransaction) |
IsolationLevel |
指定適用於此交易的 IsolationLevel。 |
SupportsSavepoints |
取得指出這個 DbTransaction 執行個體是否支援資料庫儲存點的值。
如果為 |
方法
Commit() |
認可資料庫交易。 |
CommitAsync(CancellationToken) |
非同步地認可資料庫交易。 (繼承來源 DbTransaction) |
CreateObjRef(Type) |
建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject) |
Dispose() |
釋放 DbTransaction 使用的 Unmanaged 資源。 (繼承來源 DbTransaction) |
Dispose(Boolean) |
釋放 DbTransaction 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。 (繼承來源 DbTransaction) |
DisposeAsync() |
非同步地處置交易物件。 (繼承來源 DbTransaction) |
Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
GetLifetimeService() |
已淘汰.
擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject) |
GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
InitializeLifetimeService() |
已淘汰.
取得存留期服務物件,以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject) |
MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
MemberwiseClone(Boolean) |
建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject) |
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) |
明確介面實作
IDbTransaction.Connection |
取得與交易相關聯的 DbConnection 物件,如果交易已不再有效,則為 Null 參考。 (繼承來源 DbTransaction) |
IDisposable.Dispose() |
此 API 支援此產品基礎結構,但無法直接用於程式碼之中。 將 OdbcTransaction 類別的目前執行個體所使用的資源釋出。 |
擴充方法
ConfigureAwait(IAsyncDisposable, Boolean) |
設定如何執行從非同步可處置項目傳回的工作 await。 |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應