SqlTransaction.Rollback Methode

Definitie

Naamruimte:: System.Data.SqlClient

Assembly:: System.Data.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Rolt een transactie terug van een status in behandeling.

Overloads

Name	Description
Rollback()	Rolt een transactie terug van een status in behandeling.
Rollback(String)	Hiermee wordt een transactie teruggedraaid van de status In behandeling en wordt de naam van de transactie of het savepoint opgegeven.

Rollback()

Rolt een transactie terug van een status in behandeling.

public:
 virtual void Rollback();

public:
 override void Rollback();

public void Rollback();

public override void Rollback();

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

override this.Rollback : unit -> unit

Public Sub Rollback ()

Public Overrides Sub Rollback ()

Implementeringen

Rollback()

Uitzonderingen

Exception

Er is een fout opgetreden tijdens het doorvoeren van de transactie.

InvalidOperationException

De transactie is al doorgevoerd of teruggedraaid.

– of –

De verbinding is verbroken.

Voorbeelden

In het volgende voorbeeld wordt een SqlConnection en een SqlTransaction. Het laat ook zien hoe u de BeginTransaction, Commiten Rollback methoden gebruikt. De transactie wordt teruggedraaid op een fout. Try / Catch foutafhandeling wordt gebruikt om eventuele fouten af te handelen bij het doorvoeren of terugdraaien van de transactie.

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

Opmerkingen

De methode Rollback is gelijk aan de Transact-SQL ROLLBACK TRANSACTION-instructie. Zie ROLLBACK TRANSACTION (Transact-SQL) voor meer informatie.

De transactie kan alleen worden teruggedraaid vanuit een status in behandeling (nadat BeginTransaction deze is aangeroepen, maar voordat Commit deze wordt aangeroepen). De transactie wordt teruggedraaid in het geval dat deze wordt verwijderd voor Commit of Rollback wordt aangeroepen.

Note

Try / Catch uitzonderingsafhandeling moet altijd worden gebruikt bij het terugdraaien van een transactie. Er Rollback wordt een InvalidOperationException gegenereerd als de verbinding wordt beëindigd of als de transactie al is teruggedraaid op de server.

Zie Transactions (Transact-SQL) voor meer informatie over SQL Server transacties.

Zie ook

Van toepassing op

Rollback(String)

Hiermee wordt een transactie teruggedraaid van de status In behandeling en wordt de naam van de transactie of het savepoint opgegeven.

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

public void Rollback(string transactionName);

member this.Rollback : string -> unit

override this.Rollback : string -> unit

Public Sub Rollback (transactionName As String)

Parameters

transactionName: String

De naam van de transactie die moet worden teruggedraaid of het opslagpunt waarop u wilt terugdraaien.

Uitzonderingen

ArgumentException

Er is geen transactienaam opgegeven.

InvalidOperationException

De transactie is al doorgevoerd of teruggedraaid.

– of –

De verbinding is verbroken.

Voorbeelden

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

Opmerkingen

De methode Rollback is gelijk aan de Transact-SQL ROLLBACK TRANSACTION-instructie. Zie Transactions (Transact-SQL) voor meer informatie.

De transactie kan alleen worden teruggedraaid vanuit een status in behandeling (nadat BeginTransaction deze is aangeroepen, maar voordat Commit deze wordt aangeroepen). De transactie wordt teruggedraaid als deze eerder Commit wordt verwijderd of Rollback wordt aangeroepen.

Note

Zie Transactions (Transact-SQL) voor meer informatie over SQL Server transacties.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?