SqlTransaction Classe
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.
Representa uma transação Transact-SQL a ser feita em um banco de dados do SQL Server. Essa classe não pode ser herdada.
public ref class SqlTransaction sealed : System::Data::Common::DbTransaction
public sealed class SqlTransaction : System.Data.Common.DbTransaction
type SqlTransaction = class
inherit DbTransaction
Public NotInheritable Class SqlTransaction
Inherits DbTransaction
- Herança
-
SqlTransaction
Exemplos
O exemplo a seguir cria um SqlConnection e um SqlTransaction. Ele também demonstra como usar os BeginTransactionmétodos , Commite Rollback . A transação é revertida em qualquer erro ou se for descartada sem primeiro ser confirmada. Try
/Catch
O tratamento de erros é usado para lidar com erros ao tentar confirmar ou reverter a transação.
using Microsoft.Data.SqlClient;
namespace Transaction1CS
{
class Program
{
static void Main()
{
string connectionString =
"Persist Security Info=False;Integrated Security=SSPI;database=Northwind;server=(local)";
ExecuteSqlTransaction(connectionString);
Console.ReadLine();
}
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);
}
}
}
}
}
}
Comentários
O aplicativo cria um SqlTransaction objeto chamando BeginTransaction no SqlConnection objeto . Todas as operações subsequentes associadas à transação (por exemplo, confirmar ou anular a transação) são executadas no SqlTransaction objeto .
Observação
Try
/Catch
O tratamento de exceções sempre deve ser usado ao confirmar ou reverter um SqlTransaction. E CommitRollback geram 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 Transações explícitas e transações eficientes de codificação.
Propriedades
Connection |
Obtém o objeto SqlConnection associado à transação ou |
IsolationLevel |
Especifica o IsolationLevel para essa transação. |
Métodos
Commit() |
Confirma a transação do banco de dados. |
Rollback() |
Reverte uma transação de um estado pendente. |
Rollback(String) |
Reverte uma transação de um estado pendente e especifica o nome de ponto de salvamento ou da transação. |
Save(String) |
Cria um ponto de salvamento na transação, que pode ser usado para reverter uma parte da transação e especifica o nome do ponto de salvamento. |