Freigeben über

SqlConnection.BeginTransaction Methode

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

Startet eine Datenbanktransaktion.

Überlädt

BeginTransaction()

Startet eine Datenbanktransaktion.
BeginTransaction(IsolationLevel)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad.
BeginTransaction(String)

Startet eine Datenbanktransaktion mit dem angegebenen Transaktionsnamen.
BeginTransaction(IsolationLevel, String)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad und Transaktionsnamen.

BeginTransaction()

Startet eine Datenbanktransaktion.

public:
 System::Data::SqlClient::SqlTransaction ^ BeginTransaction();
public System.Data.SqlClient.SqlTransaction BeginTransaction ();
override this.BeginTransaction : unit -> System.Data.SqlClient.SqlTransaction
member this.BeginTransaction : unit -> System.Data.SqlClient.SqlTransaction
Public Function BeginTransaction () As SqlTransaction

Gibt zurück

SqlTransaction

Ein Objekt, das die neue Transaktion darstellt.

Ausnahmen

SqlException

Parallele Transaktionen sind bei Verwendung von MARS (Multiple Active Result Sets) nicht zulässig.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel werden eine SqlConnection und eine SqlTransactionerstellt. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , Commitund Rollback verwendet werden.

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

Hinweise

Dieser Befehl wird der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

Sie müssen die Transaktion explizit committen oder ein Rollback mithilfe der Commit -Methode oder Rollback ausführen. Um sicherzustellen, dass das .NET Framework-Datenanbieter für SQL Server Transaktionsverwaltungsmodell ordnungsgemäß funktioniert, vermeiden Sie die Verwendung anderer Transaktionsverwaltungsmodelle, z. B. des von SQL Server bereitgestellten.

Hinweis

Wenn Sie keine Isolationsstufe angeben, wird die Standardisolationsstufe verwendet. Um eine Isolationsstufe mit der BeginTransaction -Methode anzugeben, verwenden Sie die Überladung, die den iso Parameter (BeginTransaction) akzeptiert. Die für eine Transaktion festgelegte Isolationsstufe wird nach Abschluss der Transaktion und bis zum Schließen oder Löschen der Verbindung beibehalten. Das Festlegen der Isolationsstufe auf Momentaufnahme in einer Datenbank, in der die Momentaufnahme Isolationsstufe nicht aktiviert ist, löst keine Ausnahme aus. Die Transaktion wird mit der Standardisolationsstufe abgeschlossen.

Achtung

Wenn eine Transaktion gestartet wird und auf dem Server ein Fehler der Ebene 16 oder höher auftritt, wird für die Transaktion erst ein Rollback ausgeführt, wenn die Read Methode aufgerufen wird. Für ExecuteReader wird keine Ausnahme ausgelöst.

Achtung

Wenn Ihre Abfrage eine große Datenmenge zurückgibt und aufruftBeginTransaction, wird eine SqlException ausgelöst, da SQL Server bei Verwendung von MARS keine parallelen Transaktionen zulässt. Um dieses Problem zu vermeiden, ordnen Sie immer eine Transaktion dem Befehl, der Verbindung oder beiden zu, bevor Leser geöffnet sind.

Weitere Informationen zu SQL Server Transaktionen finden Sie unter Transaktionen (Transact-SQL).

Weitere Informationen

Gilt für:

BeginTransaction(IsolationLevel)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad.

public:
 System::Data::SqlClient::SqlTransaction ^ BeginTransaction(System::Data::IsolationLevel iso);
public System.Data.SqlClient.SqlTransaction BeginTransaction (System.Data.IsolationLevel iso);
override this.BeginTransaction : System.Data.IsolationLevel -> System.Data.SqlClient.SqlTransaction
member this.BeginTransaction : System.Data.IsolationLevel -> System.Data.SqlClient.SqlTransaction
Public Function BeginTransaction (iso As IsolationLevel) As SqlTransaction

Parameter

iso
IsolationLevel

Die Isolationsstufe, unter der die Transaktion ausgeführt werden soll.

Gibt zurück

SqlTransaction

Ein Objekt, das die neue Transaktion darstellt.

Ausnahmen

SqlException

Parallele Transaktionen sind bei Verwendung von MARS (Multiple Active Result Sets) nicht zulässig.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel werden eine SqlConnection und eine SqlTransactionerstellt. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , Commitund Rollback verwendet werden.

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(IsolationLevel.ReadCommitted);

        // 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();
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception e)
        {
            try
            {
                transaction.Rollback();
            }
            catch (SqlException ex)
            {
                if (transaction.Connection != null)
                {
                    Console.WriteLine("An exception of type " + ex.GetType() +
                        " was encountered while attempting to roll back the transaction.");
                }
            }

            Console.WriteLine("An exception of type " + e.GetType() +
                " was encountered while inserting the data.");
            Console.WriteLine("Neither record was written to database.");
        }
    }
}

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(IsolationLevel.ReadCommitted)
        ' 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()
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")
        Catch e As Exception
            Try
                transaction.Rollback()
            Catch ex As SqlException
                If Not transaction.Connection Is Nothing Then
                    Console.WriteLine("An exception of type " & ex.GetType().ToString() & _
                      " was encountered while attempting to roll back the transaction.")
                End If
            End Try

            Console.WriteLine("An exception of type " & e.GetType().ToString() & _
              "was encountered while inserting the data.")
            Console.WriteLine("Neither record was written to database.")
        End Try
    End Using
End Sub

Hinweise

Dieser Befehl wird der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

Sie müssen die Transaktion explizit committen oder ein Rollback mithilfe der Commit -Methode oder Rollback ausführen. Um sicherzustellen, dass das .NET Framework-Datenanbieter für SQL Server Transaktionsverwaltungsmodell ordnungsgemäß funktioniert, vermeiden Sie die Verwendung anderer Transaktionsverwaltungsmodelle, z. B. des von SQL Server bereitgestellten.

Hinweis

Nachdem ein Commit für eine Transaktion ausgeführt oder ein Rollback ausgeführt wurde, bleibt die Isolationsstufe der Transaktion für alle nachfolgenden Befehle im Autocommit-Modus (Standardeinstellung SQL Server) erhalten. Dies kann zu unerwarteten Ergebnissen führen, z. B. zu einer Isolationsstufe von REPEATABLE READ, die dauerhaft bleibt und andere Benutzer aus einer Zeile sperrt. Um die Isolationsstufe auf den Standardwert (READ COMMITTED) zurückzusetzen, führen Sie die Transact-SQL SET TRANSACTION ISOLATION LEVEL READ COMMITTED-Anweisung aus, oder rufen Sie SqlConnection.BeginTransaction unmittelbar gefolgt von auf SqlTransaction.Commit. Weitere Informationen zu SQL Server Isolationsstufen finden Sie unter Transaktionsisolationsstufen.

Weitere Informationen zu SQL Server Transaktionen finden Sie unter Transaktionen (Transact-SQL).

Achtung

Wenn Ihre Abfrage eine große Datenmenge zurückgibt und aufruftBeginTransaction, wird eine SqlException ausgelöst, da SQL Server bei Verwendung von MARS keine parallelen Transaktionen zulässt. Um dieses Problem zu vermeiden, ordnen Sie immer eine Transaktion dem Befehl, der Verbindung oder beiden zu, bevor Leser geöffnet sind.

Weitere Informationen

Gilt für:

BeginTransaction(String)

Startet eine Datenbanktransaktion mit dem angegebenen Transaktionsnamen.

public:
 System::Data::SqlClient::SqlTransaction ^ BeginTransaction(System::String ^ transactionName);
public System.Data.SqlClient.SqlTransaction BeginTransaction (string transactionName);
override this.BeginTransaction : string -> System.Data.SqlClient.SqlTransaction
member this.BeginTransaction : string -> System.Data.SqlClient.SqlTransaction
Public Function BeginTransaction (transactionName As String) As SqlTransaction

Parameter

transactionName
String

Der Name der Transaktion.

Gibt zurück

SqlTransaction

Ein Objekt, das die neue Transaktion darstellt.

Ausnahmen

SqlException

Parallele Transaktionen sind bei Verwendung von MARS (Multiple Active Result Sets) nicht zulässig.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel werden eine SqlConnection und eine SqlTransactionerstellt. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , Commitund Rollback verwendet werden.

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

Hinweise

Dieser Befehl wird der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

Die Länge des transactionName Parameters darf 32 Zeichen nicht überschreiten, andernfalls wird eine Ausnahme ausgelöst.

Der Wert im transactionName -Parameter kann in späteren Aufrufen von Rollback und im savePoint -Parameter der Save -Methode verwendet werden.

Sie müssen die Transaktion explizit committen oder ein Rollback mithilfe der Commit -Methode oder Rollback ausführen. Um sicherzustellen, dass das .NET Framework-Datenanbieter für SQL Server Transaktionsverwaltungsmodell ordnungsgemäß funktioniert, vermeiden Sie die Verwendung anderer Transaktionsverwaltungsmodelle, z. B. des von SQL Server bereitgestellten.

Weitere Informationen zu SQL Server Transaktionen finden Sie unter Transaktionen (Transact-SQL).

Achtung

Wenn Ihre Abfrage eine große Datenmenge zurückgibt und aufruftBeginTransaction, wird eine SqlException ausgelöst, da SQL Server bei Verwendung von MARS keine parallelen Transaktionen zulässt. Um dieses Problem zu vermeiden, ordnen Sie immer eine Transaktion dem Befehl, der Verbindung oder beiden zu, bevor Leser geöffnet sind.

Weitere Informationen

Gilt für:

BeginTransaction(IsolationLevel, String)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad und Transaktionsnamen.

public:
 System::Data::SqlClient::SqlTransaction ^ BeginTransaction(System::Data::IsolationLevel iso, System::String ^ transactionName);
public System.Data.SqlClient.SqlTransaction BeginTransaction (System.Data.IsolationLevel iso, string transactionName);
override this.BeginTransaction : System.Data.IsolationLevel * string -> System.Data.SqlClient.SqlTransaction
member this.BeginTransaction : System.Data.IsolationLevel * string -> System.Data.SqlClient.SqlTransaction
Public Function BeginTransaction (iso As IsolationLevel, transactionName As String) As SqlTransaction

Parameter

iso
IsolationLevel

Die Isolationsstufe, unter der die Transaktion ausgeführt werden soll.

transactionName
String

Der Name der Transaktion.

Gibt zurück

SqlTransaction

Ein Objekt, das die neue Transaktion darstellt.

Ausnahmen

SqlException

Parallele Transaktionen sind bei Verwendung von MARS (Multiple Active Result Sets) nicht zulässig.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel werden eine SqlConnection und eine SqlTransactionerstellt. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , Commitund Rollback verwendet werden.

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(
            IsolationLevel.ReadCommitted, "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();
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception e)
        {
            try
            {
                transaction.Rollback("SampleTransaction");
            }
            catch (SqlException ex)
            {
                if (transaction.Connection != null)
                {
                    Console.WriteLine("An exception of type " + ex.GetType() +
                        " was encountered while attempting to roll back the transaction.");
                }
            }

            Console.WriteLine("An exception of type " + e.GetType() +
                " was encountered while inserting the data.");
            Console.WriteLine("Neither record was written to database.");
        }
    }
}

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( _
          IsolationLevel.ReadCommitted, "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()
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")
        Catch e As Exception
            Try
                transaction.Rollback("SampleTransaction")
            Catch ex As SqlException
                If Not transaction.Connection Is Nothing Then
                    Console.WriteLine("An exception of type " & ex.GetType().ToString() & _
                      " was encountered while attempting to roll back the transaction.")
                End If
            End Try

            Console.WriteLine("An exception of type " & e.GetType().ToString() & _
              "was encountered while inserting the data.")
            Console.WriteLine("Neither record was written to database.")
        End Try
    End Using
End Sub

Hinweise

Dieser Befehl wird der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

Der Wert im transactionName -Parameter kann in späteren Aufrufen von Rollback und im savePoint -Parameter der Save -Methode verwendet werden.

Sie müssen die Transaktion explizit committen oder ein Rollback mithilfe der Commit -Methode oder Rollback ausführen. Um sicherzustellen, dass das SQL Server Transaktionsverwaltungsmodell ordnungsgemäß funktioniert, vermeiden Sie die Verwendung anderer Transaktionsverwaltungsmodelle, z. B. des von SQL Server bereitgestellten.

Hinweis

Nachdem ein Commit für eine Transaktion ausgeführt oder ein Rollback ausgeführt wurde, bleibt die Isolationsstufe der Transaktion für alle nachfolgenden Befehle im Autocommit-Modus (Standardeinstellung SQL Server) erhalten. Dies kann zu unerwarteten Ergebnissen führen, z. B. zu einer Isolationsstufe von REPEATABLE READ, die dauerhaft bleibt und andere Benutzer aus einer Zeile sperrt. Um die Isolationsstufe auf den Standardwert (READ COMMITTED) zurückzusetzen, führen Sie die Transact-SQL SET TRANSACTION ISOLATION LEVEL READ COMMITTED-Anweisung aus, oder rufen Sie SqlConnection.BeginTransaction unmittelbar gefolgt von auf SqlTransaction.Commit. Weitere Informationen zu SQL Server Isolationsstufen finden Sie unter Transaktionsisolationsstufen.

Weitere Informationen zu SQL Server Transaktionen finden Sie unter Transaktionen (Transact-SQL).

Achtung

Wenn Ihre Abfrage eine große Datenmenge zurückgibt und aufruftBeginTransaction, wird eine SqlException ausgelöst, da SQL Server bei Verwendung von MARS keine parallelen Transaktionen zulässt. Um dieses Problem zu vermeiden, ordnen Sie immer eine Transaktion dem Befehl, der Verbindung oder beiden zu, bevor Leser geöffnet sind.

Weitere Informationen

Gilt für: