OleDbConnection.BeginTransaction Méthode

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

System.Data.OleDb v11.0.0-preview.4.26230.115

Démarre une transaction de base de données.

Surcharges

Nom	Description
BeginTransaction()	Démarre une transaction de base de données avec la valeur actuelle IsolationLevel .
BeginTransaction(IsolationLevel)	Démarre une transaction de base de données avec le niveau d’isolation spécifié.

BeginTransaction()

Source:

OleDbConnection.cs

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

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

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 BeginTransaction les CommitRollbackmé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 ou Commit de la Rollback méthode. Pour vous assurer que le Fournisseur de données Framework .NET 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)

Source:

OleDbConnection.cs

Démarre une transaction de base de données avec le niveau d’isolation 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

Public Function BeginTransaction (isolationLevel As IsolationLevel) As OleDbTransaction

Paramètres

isolationLevel

IsolationLevel

Niveau d’isolation 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 BeginTransactionméthodes, a et Commit les Rollbackmé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 ou Commit de la Rollback méthode. Pour vous assurer que le Fournisseur de données Framework .NET 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.

Note

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 accepte le isolationLevel paramètre.

Voir aussi

• Connexion à des sources de données