SqlConnection.BeginTransaction Methode

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Startet eine Datenbanktransaktion.

Überlädt

Name	Beschreibung
BeginTransaction()	Startet eine Datenbanktransaktion.
BeginTransaction(IsolationLevel)	Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe.
BeginTransaction(String)	Startet eine Datenbanktransaktion mit dem angegebenen Transaktionsnamen.
BeginTransaction(IsolationLevel, String)	Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe und dem Transaktionsnamen.

BeginTransaction()

Quelle:: System.Data.SqlClient.notsupported.cs

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 nicht zulässig, wenn mehrere aktive Resultsets (MARS) verwendet werden.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel wird eine SqlConnection und eine SqlTransaction. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , a Commitund Rollback A 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 ist der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

Sie müssen die Transaktion mit der oder der Commit Methode explizit commiten oder Rollback zurücksetzen. Um sicherzustellen, dass das .NET Framework-Datenanbieter für SQL Server Transaktionsverwaltungsmodell ordnungsgemäß ausgeführt wird, vermeiden Sie die Verwendung anderer Transaktionsverwaltungsmodelle, z. B. die von SQL Server bereitgestellte.

Note

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) verwendet. Die für eine Transaktion festgelegte Isolationsstufe wird nach Abschluss der Transaktion beibehalten und bis die Verbindung geschlossen oder verworfen wird. Das Festlegen der Isolationsstufe auf "Snapshot " in einer Datenbank, in der die Momentaufnahmeisolationsstufe nicht aktiviert ist, löst keine Ausnahme aus. Die Transaktion wird mit der Standardisolationsstufe abgeschlossen.

Vorsicht

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

Vorsicht

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

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

Weitere Informationen

Gilt für:

BeginTransaction(IsolationLevel)

Quelle:: System.Data.SqlClient.notsupported.cs

Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe.

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 nicht zulässig, wenn mehrere aktive Resultsets (MARS) verwendet werden.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel wird eine SqlConnection und eine SqlTransaction. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , a Commitund Rollback A 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 ist der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

Note

Nachdem eine Transaktion zugesichert oder zurückgesetzt wurde, wird die Isolationsstufe der Transaktion für alle nachfolgenden Befehle beibehalten, die sich im Autocommit-Modus befinden (standardeinstellung SQL Server). Dies kann zu unerwarteten Ergebnissen führen, z. B. eine Isolationsstufe wiederholter LESEvorgänge, die beibehalten und andere Benutzer aus einer Zeile sperren. Führen Sie die Transact-SQL SET TRANSACTION ISOLATION LEVEL READ COMMITTED-Anweisung aus, oder rufen Sie SqlConnection.BeginTransaction gefolgt von SqlTransaction.Commit auf, um die Isolationsstufe auf die Standardeinstellung zurückzusetzen (READ COMMIT). Weitere Informationen zu SQL Server Isolationsstufen finden Sie unter Transaction Isolation Levels.

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

Vorsicht

Weitere Informationen

Gilt für:

BeginTransaction(String)

Quelle:: System.Data.SqlClient.notsupported.cs

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 nicht zulässig, wenn mehrere aktive Resultsets (MARS) verwendet werden.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel wird eine SqlConnection und eine SqlTransaction. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , a Commitund Rollback A 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 ist 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 Rollback und im savePoint Parameter der Save Methode verwendet werden.

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

Vorsicht

Weitere Informationen

Gilt für:

BeginTransaction(IsolationLevel, String)

Quelle:: System.Data.SqlClient.notsupported.cs

Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe und dem 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 nicht zulässig, wenn mehrere aktive Resultsets (MARS) verwendet werden.

InvalidOperationException

Parallele Transaktionen werden nicht unterstützt.

Beispiele

Im folgenden Beispiel wird eine SqlConnection und eine SqlTransaction. Außerdem wird veranschaulicht, wie die BeginTransactionMethoden , a Commitund Rollback A 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 ist der SQL Server Implementierung von BEGIN TRANSACTION zugeordnet.

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

Sie müssen die Transaktion mit der oder der Commit Methode explizit commiten oder Rollback zurücksetzen. Um sicherzustellen, dass das SQL Server Transaktionsverwaltungsmodell ordnungsgemäß ausgeführt wird, vermeiden Sie die Verwendung anderer Transaktionsverwaltungsmodelle, z. B. die von SQL Server bereitgestellte.

Note

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

Vorsicht

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?