SqlTransaction.Rollback Метод

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.SqlClient.dll

Сборка:: System.Data.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Откат транзакции из ожидающего состояния.

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

Перегрузки

Имя.	Описание
Rollback()	Откат транзакции из ожидающего состояния. Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
Rollback(String)	Откат транзакции из ожидающего состояния и указывает имя транзакции или точки сохранения. Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

Имя.

Описание

Rollback()

Откат транзакции из ожидающего состояния.

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

Rollback(String)

Откат транзакции из ожидающего состояния и указывает имя транзакции или точки сохранения.

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

Rollback()

Исходный код:: System.Data.SqlClient.notsupported.cs

Откат транзакции из ожидающего состояния.

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

public:
 override void Rollback();

public:
 virtual void Rollback();

public override void Rollback();

public void Rollback();

override this.Rollback : unit -> unit

abstract member Rollback : unit -> unit
override this.Rollback : unit -> unit

Public Overrides Sub Rollback ()

Public Sub Rollback ()

Реализации

Rollback()

Исключения

Exception

Произошла ошибка при попытке фиксации транзакции.

InvalidOperationException

Транзакция уже зафиксирована или откатена.

–или–

Подключение нарушено.

Примеры

В следующем примере создается SqlConnection и a SqlTransaction. В нем также показано, как использовать BeginTransaction Commitметоды и Rollback методы. Транзакция откатывается по любой ошибке. Try / Catch Обработка ошибок используется для обработки ошибок при попытке фиксации или отката транзакции.

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

Транзакцию можно откатить только из ожидающего состояния (после BeginTransaction вызова, но до Commit вызова). Транзакция откатывается в случае, если она удаляется до Commit или Rollback вызывается.

Note

Try / Catch Обработка исключений всегда должна использоваться при откате транзакции. Возникает Rollback ошибка InvalidOperationException , если подключение завершается или если транзакция уже была откатена на сервере.

Дополнительные сведения о транзакциях SQL Server см. в разделе Transactions (Transact-SQL).

См. также

Применяется к

Rollback(String)

Исходный код:: System.Data.SqlClient.notsupported.cs

Откат транзакции из ожидающего состояния и указывает имя транзакции или точки сохранения.

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

public:
 void Rollback(System::String ^ transactionName);

public void Rollback(string transactionName);

override this.Rollback : string -> unit

member this.Rollback : string -> unit

Public Sub Rollback (transactionName As String)

Параметры

transactionName: String

Имя транзакции для отката или точки сохранения, в которую необходимо выполнить откат.

Исключения

ArgumentException

Имя транзакции не указано.

InvalidOperationException

Транзакция уже зафиксирована или откатена.

–или–

Подключение нарушено.

Примеры

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("SampleTransaction");

        // 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("SampleTransaction");
            }
            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("SampleTransaction")

        ' 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("Exception Type: {0}", ex.GetType())
            Console.WriteLine("  Message: {0}", ex.Message)

            ' Attempt to roll back the transaction.
            Try
                transaction.Rollback("SampleTransaction")

            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

Транзакцию можно откатить только из ожидающего состояния (после BeginTransaction вызова, но до Commit вызова). Транзакция откатывается, если она удаляется до Commit или Rollback вызывается.

Note

Дополнительные сведения о транзакциях SQL Server см. в разделе Transactions (Transact-SQL).

См. также

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

SqlTransaction.Rollback Метод

Определение

Перегрузки

Rollback()

Реализации

Исключения

Примеры

Комментарии

См. также

Применяется к

Rollback(String)

Параметры

Исключения

Примеры

Комментарии

См. также

Применяется к