SqlTransaction Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una transazione Transact-SQL da eseguire in un database SQL Server. La classe non può essere ereditata.
public ref class SqlTransaction sealed : MarshalByRefObject, IDisposable, System::Data::IDbTransaction
public ref class SqlTransaction sealed : System::Data::Common::DbTransaction
public sealed class SqlTransaction : MarshalByRefObject, IDisposable, System.Data.IDbTransaction
public sealed class SqlTransaction : System.Data.Common.DbTransaction
type SqlTransaction = class
inherit MarshalByRefObject
interface IDbTransaction
interface IDisposable
type SqlTransaction = class
inherit DbTransaction
Public NotInheritable Class SqlTransaction
Inherits MarshalByRefObject
Implements IDbTransaction, IDisposable
Public NotInheritable Class SqlTransaction
Inherits DbTransaction
- Ereditarietà
- Ereditarietà
- Implementazioni
Esempio
Nell'esempio seguente viene creato un SqlConnection oggetto e un oggetto SqlTransaction. Viene inoltre illustrato come usare i BeginTransactionmetodi , Commite Rollback . Viene eseguito il rollback della transazione in caso di errore o se viene eliminato senza prima essere sottoposto a commit.
Try
/
Catch la gestione degli errori viene usata per gestire eventuali errori durante il tentativo di eseguire il commit o il rollback della transazione.
private static void ExecuteSqlTransaction(string connectionString)
{
using (SqlConnection connection = new SqlConnection(connectionString))
{
connection.Open();
SqlCommand command = connection.CreateCommand();
SqlTransaction transaction;
// Start a local transaction.
transaction = connection.BeginTransaction();
// Must assign both transaction object and connection
// to Command object for a pending local transaction
command.Connection = connection;
command.Transaction = transaction;
try
{
command.CommandText =
"Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
command.ExecuteNonQuery();
command.CommandText =
"Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
command.ExecuteNonQuery();
// Attempt to commit the transaction.
transaction.Commit();
Console.WriteLine("Both records are written to database.");
}
catch (Exception ex)
{
Console.WriteLine("Commit Exception Type: {0}", ex.GetType());
Console.WriteLine(" Message: {0}", ex.Message);
// Attempt to roll back the transaction.
try
{
transaction.Rollback();
}
catch (Exception ex2)
{
// This catch block will handle any errors that may have occurred
// on the server that would cause the rollback to fail, such as
// a closed connection.
Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType());
Console.WriteLine(" Message: {0}", ex2.Message);
}
}
}
}
Private Sub ExecuteSqlTransaction(ByVal connectionString As String)
Using connection As New SqlConnection(connectionString)
connection.Open()
Dim command As SqlCommand = connection.CreateCommand()
Dim transaction As SqlTransaction
' Start a local transaction
transaction = connection.BeginTransaction()
' Must assign both transaction object and connection
' to Command object for a pending local transaction.
command.Connection = connection
command.Transaction = transaction
Try
command.CommandText = _
"Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
command.ExecuteNonQuery()
command.CommandText = _
"Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
command.ExecuteNonQuery()
' Attempt to commit the transaction.
transaction.Commit()
Console.WriteLine("Both records are written to database.")
Catch ex As Exception
Console.WriteLine("Commit Exception Type: {0}", ex.GetType())
Console.WriteLine(" Message: {0}", ex.Message)
' Attempt to roll back the transaction.
Try
transaction.Rollback()
Catch ex2 As Exception
' This catch block will handle any errors that may have occurred
' on the server that would cause the rollback to fail, such as
' a closed connection.
Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType())
Console.WriteLine(" Message: {0}", ex2.Message)
End Try
End Try
End Using
End Sub
Commenti
L'applicazione crea un SqlTransaction oggetto chiamando BeginTransaction sull'oggetto SqlConnection . Tutte le operazioni successive associate alla transazione , ad esempio commit o interruzione della transazione, vengono eseguite sull'oggetto SqlTransaction .
Note
Try
/
Catch La gestione delle eccezioni deve essere sempre usata durante il commit o il rollback di un oggetto SqlTransaction. Sia Commit che Rollback generano un oggetto InvalidOperationException se la connessione viene terminata o se è già stato eseguito il rollback della transazione nel server.
Per altre informazioni sulle transazioni SQL Server, vedere Explicit Transactions e Coding Efficient Transactions.
Proprietà
| Nome | Descrizione |
|---|---|
| Connection |
Ottiene l'oggetto SqlConnection associato alla transazione o |
| DbConnection |
In caso di override in una classe derivata, ottiene l'oggetto DbConnection associato alla transazione. (Ereditato da DbTransaction) |
| IsolationLevel |
Specifica l'oggetto IsolationLevel per la transazione. |
Metodi
| Nome | Descrizione |
|---|---|
| Commit() |
Esegue il commit della transazione di database. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia le risorse contenute nell'oggetto . |
| Dispose() |
Rilascia le risorse non gestite usate da DbTransaction. (Ereditato da DbTransaction) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da DbTransaction e, facoltativamente, rilascia le risorse gestite. (Ereditato da DbTransaction) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| Rollback() |
Esegue il rollback di una transazione da uno stato in sospeso. |
| Rollback(String) |
Esegue il rollback di una transazione da uno stato in sospeso e specifica il nome della transazione o del punto di salvataggio. |
| Save(String) |
Crea un punto di salvataggio nella transazione che può essere utilizzato per eseguire il rollback di una parte della transazione e specifica il nome del punto di salvataggio. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IDbTransaction.Connection |
Ottiene l'oggetto DbConnection associato alla transazione o un riferimento Null se la transazione non è più valida. (Ereditato da DbTransaction) |