OleDbConnection.BeginTransaction Méthode

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Assembly:

System.Data.dll

Commence une transaction de base de données.

Surcharges

BeginTransaction()	Commence une transaction de base de données avec la valeur IsolationLevel actuelle.
BeginTransaction(IsolationLevel)	Commence une transaction de base de données avec le niveau d’isolement spécifié.

BeginTransaction()

Commence une transaction de base de données avec la valeur IsolationLevel actuelle.

public:
 System::Data::OleDb::OleDbTransaction ^ BeginTransaction();

public System.Data.OleDb.OleDbTransaction BeginTransaction ();

override this.BeginTransaction : unit -> System.Data.OleDb.OleDbTransaction

member this.BeginTransaction : unit -> System.Data.OleDb.OleDbTransaction

Public Function BeginTransaction () As OleDbTransaction

Retours

OleDbTransaction

Objet représentant la nouvelle transaction.

Exceptions

InvalidOperationException

Les transactions parallèles ne sont pas prises en charge.

Exemples

L’exemple suivant crée un OleDbConnection et un OleDbTransaction. Il montre également comment utiliser les méthodes et CommitRollback les BeginTransactionméthodes.

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 ou Rollback de la Commit méthode. Pour vous assurer que le .NET Framework Fournisseur de données pour le modèle de gestion des transactions OLE DB fonctionne correctement, évitez d’utiliser d’autres modèles de gestion des transactions, tels que ceux fournis par la source de données.

Voir aussi

• Connexion à des sources de données

BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolement spécifié.

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

member this.BeginTransaction : System.Data.IsolationLevel -> System.Data.OleDb.OleDbTransaction

Public Function BeginTransaction (isolationLevel As IsolationLevel) As OleDbTransaction

Paramètres

isolationLevel

IsolationLevel

Niveau d’isolement sous lequel la transaction doit s’exécuter.

Retours

OleDbTransaction

Objet représentant la nouvelle transaction.

Exceptions

InvalidOperationException

Les transactions parallèles ne sont pas prises en charge.

Exemples

L’exemple suivant crée un OleDbConnection et un OleDbTransaction. Il montre également comment utiliser les méthodes, a BeginTransactionCommitet Rollback les méthodes.

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 ou Rollback de la Commit méthode. Pour vous assurer que le .NET Framework Fournisseur de données pour le modèle de gestion des transactions OLE DB fonctionne correctement, évitez d’utiliser d’autres modèles de gestion des transactions, tels que ceux fournis par la source de données.

Notes

Si vous ne spécifiez pas de niveau d’isolation, le niveau d’isolation par défaut du fournisseur sous-jacent est utilisé. Pour spécifier un niveau d’isolation avec la BeginTransaction méthode, utilisez la surcharge qui prend le isolationLevel paramètre.

Voir aussi

• Connexion à des sources de données