SqlTransaction.Commit Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Confirma a transação de banco de dados.
public:
virtual void Commit();
public:
override void Commit();
public void Commit();
public override void Commit();
abstract member Commit : unit -> unit
override this.Commit : unit -> unit
override this.Commit : unit -> unit
Public Sub Commit ()
Public Overrides Sub Commit ()
Implementações
Exceções
Erro ao tentar confirmar a transação.
A transação já foi confirmada ou revertida.
-ou-
A conexão está interrompida.
Exemplos
O exemplo a seguir cria um SqlConnection e um SqlTransaction. Ele também demonstra como usar os Commitmétodos e Rollback . BeginTransaction A transação é revertida em qualquer erro.
Try
/
Catch o tratamento de erros é usado para lidar com erros ao tentar confirmar ou reverter a transação.
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
Comentários
O método Commit é equivalente à instrução COMMIT TRANSACTION Transact-SQL. Você não pode reverter uma transação depois que ela tiver sido confirmada, pois todas as modificações se tornaram uma parte permanente do banco de dados. Para obter mais informações, consulte COMMIT TRANSACTION (Transact-SQL) .
Note
Try
/
Catch o tratamento de exceções sempre deve ser usado ao confirmar ou reverter um SqlTransaction. Ambos Commit e Rollback gera um InvalidOperationException se a conexão for encerrada ou se a transação já tiver sido revertida no servidor.
Para obter mais informações sobre transações SQL Server, consulte Transactions (Transact-SQL).