OleDbConnection.BeginTransaction Méthode

Définition

Commence une transaction de base de données.Starts a database transaction.

Surcharges

BeginTransaction()

Commence une transaction de base de données avec la valeur IsolationLevel actuelle.Starts a database transaction with the current IsolationLevel value.

BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolement spécifié.Starts a database transaction with the specified isolation level.

BeginTransaction()

Commence une transaction de base de données avec la valeur IsolationLevel actuelle.Starts a database transaction with the current IsolationLevel value.

public:
 System::Data::OleDb::OleDbTransaction ^ BeginTransaction();
public System.Data.OleDb.OleDbTransaction BeginTransaction ();
override this.BeginTransaction : unit -> System.Data.OleDb.OleDbTransaction
Public Function BeginTransaction () As OleDbTransaction

Retours

Objet représentant la nouvelle transaction.An object representing the new transaction.

Exceptions

Les transactions parallèles ne sont pas prises en charge.Parallel transactions are not supported.

Exemples

L’exemple suivant crée un OleDbConnection et un OleDbTransaction.The following example creates an OleDbConnection and an OleDbTransaction. Il montre également comment utiliser les méthodes BeginTransaction, Commitet Rollback.It also demonstrates how to use the BeginTransaction, Commit, and Rollback methods.

public void ExecuteTransaction(string connectionString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand();
        OleDbTransaction transaction = null;

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the transaction.
        try
        {
            connection.Open();

            // Start a local transaction with ReadCommitted isolation level.
            transaction = connection.BeginTransaction(IsolationLevel.ReadCommitted);

            // Assign transaction object for a pending local transaction.
            command.Connection = connection;
            command.Transaction = transaction;

            // Execute the commands.
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
            command.ExecuteNonQuery();
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
            command.ExecuteNonQuery();

            // Commit the transaction.
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
            try
            {
                // Attempt to roll back the transaction.
                transaction.Rollback();
            }
            catch
            {
                // Do nothing here; transaction is not active.
            }
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}
Public Sub ExecuteTransaction(ByVal connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand()
        Dim transaction As OleDbTransaction

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the transaction.
        Try
            connection.Open()

            ' Start a local transaction with ReadCommitted isolation level.
            transaction = connection.BeginTransaction(IsolationLevel.ReadCommitted)

            ' Assign transaction object for a pending local transaction.
            command.Connection = connection
            command.Transaction = transaction

            ' Execute the commands.
            command.CommandText = _
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
            command.ExecuteNonQuery()
            command.CommandText = _
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
            command.ExecuteNonQuery()

            ' Commit the transaction.
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")

        Catch ex As Exception
            Console.WriteLine(ex.Message)
            ' Try to rollback the transaction
            Try
                    transaction.Rollback()

            Catch
                ' Do nothing here; transaction is not active.
            End Try
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Remarques

Vous devez valider ou restaurer explicitement la transaction à l’aide de la méthode Commit ou Rollback.You must explicitly commit or roll back the transaction using the Commit or Rollback method. Pour vous assurer que le .NET Framework Fournisseur de données pour le modèle de gestion des transactions OLE DB s’exécute correctement, évitez d’utiliser d’autres modèles de gestion des transactions, tels que ceux fournis par la source de données.To make sure that the .NET Framework Data Provider for OLE DB transaction management model performs correctly, avoid using other transaction management models, such as those provided by the data source.

Voir aussi

BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolement spécifié.Starts a database transaction with the specified isolation level.

public:
 System::Data::OleDb::OleDbTransaction ^ BeginTransaction(System::Data::IsolationLevel isolationLevel);
public System.Data.OleDb.OleDbTransaction BeginTransaction (System.Data.IsolationLevel isolationLevel);
override this.BeginTransaction : System.Data.IsolationLevel -> System.Data.OleDb.OleDbTransaction

Paramètres

isolationLevel
IsolationLevel

Niveau d’isolement sous lequel la transaction doit s’exécuter.The isolation level under which the transaction should run.

Retours

Objet représentant la nouvelle transaction.An object representing the new transaction.

Exceptions

Les transactions parallèles ne sont pas prises en charge.Parallel transactions are not supported.

Exemples

L’exemple suivant crée un OleDbConnection et un OleDbTransaction.The following example creates an OleDbConnection and an OleDbTransaction. Il montre également comment utiliser les méthodes BeginTransaction, Commitet Rollback.It also demonstrates how to use the BeginTransaction, a Commit, and Rollback methods.

public void ExecuteTransaction(string connectionString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand();
        OleDbTransaction transaction = null;

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the transaction.
        try
        {
            connection.Open();

            // Start a local transaction
            transaction = connection.BeginTransaction();

            // Assign transaction object for a pending local transaction.
            command.Connection = connection;
            command.Transaction = transaction;

            // Execute the commands.
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')";
            command.ExecuteNonQuery();
            command.CommandText =
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')";
            command.ExecuteNonQuery();

            // Commit the transaction.
            transaction.Commit();
            Console.WriteLine("Both records are written to database.");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
            try
            {
                // Attempt to roll back the transaction.
                transaction.Rollback();
            }
            catch
            {
                // Do nothing here; transaction is not active.
            }
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}
Public Sub ExecuteTransaction(ByVal connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand()
        Dim transaction As OleDbTransaction

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the transaction.
        Try
            connection.Open()

            ' Start a local transaction.
            transaction = connection.BeginTransaction()

            ' Assign transaction object for a pending local transaction.
            command.Connection = connection
            command.Transaction = transaction

            ' Execute the commands.
            command.CommandText = _
                "Insert into Region (RegionID, RegionDescription) VALUES (100, 'Description')"
            command.ExecuteNonQuery()
            command.CommandText = _
                "Insert into Region (RegionID, RegionDescription) VALUES (101, 'Description')"
            command.ExecuteNonQuery()

            ' Commit the transaction.
            transaction.Commit()
            Console.WriteLine("Both records are written to database.")

        Catch ex As Exception
            Console.WriteLine(ex.Message)
            ' Try to rollback the transaction
            Try
                    transaction.Rollback()

            Catch
                ' Do nothing here; transaction is not active.
            End Try
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Remarques

Vous devez valider ou restaurer explicitement la transaction à l’aide de la méthode Commit ou Rollback.You must explicitly commit or roll back the transaction using the Commit or Rollback method. Pour vous assurer que le .NET Framework Fournisseur de données pour le modèle de gestion des transactions OLE DB s’exécute correctement, évitez d’utiliser d’autres modèles de gestion des transactions, tels que ceux fournis par la source de données.To make sure that the .NET Framework Data Provider for OLE DB transaction management model performs correctly, avoid using other transaction management models, such as those provided by the data source.

Notes

Si vous ne spécifiez pas de niveau d’isolation, le niveau d’isolation par défaut pour le fournisseur sous-jacent est utilisé.If you do not specify an isolation level, the default isolation level for the underlying provider is used. Pour spécifier un niveau d’isolation à l’aide de la méthode BeginTransaction, utilisez la surcharge qui prend le paramètre isolationLevel.To specify an isolation level with the BeginTransaction method, use the overload that takes the isolationLevel parameter.

Voir aussi

S’applique à