OdbcConnection.BeginTransaction Méthode

Définition

Espace de noms:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paquet:

System.Data.Odbc v8.0.0

Commence une transaction dans la source de données.

Surcharges

BeginTransaction()	Commence une transaction dans la source de données.
BeginTransaction(IsolationLevel)	Commence une transaction dans la source de données avec la valeur IsolationLevel spécifiée.

BeginTransaction()

Source:

OdbcConnection.cs

Commence une transaction dans la source de données.

public:
 System::Data::Odbc::OdbcTransaction ^ BeginTransaction();

public System.Data.Odbc.OdbcTransaction BeginTransaction ();

override this.BeginTransaction : unit -> System.Data.Odbc.OdbcTransaction

Public Function BeginTransaction () As OdbcTransaction

Retours

OdbcTransaction

Objet représentant la nouvelle transaction.

Exceptions

InvalidOperationException

Une transaction est active. Les transactions parallèles ne sont pas prises en charge.

Exemples

L’exemple suivant crée un OdbcConnection et un OdbcTransaction. Il montre également comment utiliser les BeginTransactionméthodes , Commitet .Rollback

public static void ExecuteTransaction(string connectionString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand();
        OdbcTransaction transaction = null;

        // Set the Connection to the new OdbcConnection.
        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 OdbcConnection(connectionString)
        Dim command As New OdbcCommand()
        Dim transaction As OdbcTransaction

        ' Set the Connection to the new OdbcConnection.
        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

Pour valider ou restaurer la transaction, vous devez utiliser explicitement les Commit méthodes ou Rollback .

Pour vous assurer que le modèle de gestion des transactions du fournisseur de données .NET Framework pour ODBC 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 est déterminé par le pilote utilisé. Pour spécifier un niveau d’isolation avec la BeginTransaction méthode, utilisez la surcharge qui prend le isolevel paramètre.

Voir aussi

• Connexion à des sources de données

BeginTransaction(IsolationLevel)

Source:

OdbcConnection.cs

Commence une transaction dans la source de données avec la valeur IsolationLevel spécifiée.

public:
 System::Data::Odbc::OdbcTransaction ^ BeginTransaction(System::Data::IsolationLevel isolevel);

public System.Data.Odbc.OdbcTransaction BeginTransaction (System.Data.IsolationLevel isolevel);

override this.BeginTransaction : System.Data.IsolationLevel -> System.Data.Odbc.OdbcTransaction

Public Function BeginTransaction (isolevel As IsolationLevel) As OdbcTransaction

Paramètres

isolevel

IsolationLevel

Niveau d'isolement des transactions pour cette connexion. Si vous ne spécifiez pas un niveau d'isolement, le niveau d'isolement par défaut pour le pilote est utilisé.

Retours

OdbcTransaction

Objet représentant la nouvelle transaction.

Exceptions

InvalidOperationException

Une transaction est active. Les transactions parallèles ne sont pas prises en charge.

Exemples

L’exemple suivant crée un OdbcConnection et un OdbcTransaction. Il montre également comment utiliser les BeginTransactionméthodes , Commitet .Rollback

public static void ExecuteTransaction(string connectionString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand();
        OdbcTransaction transaction = null;

        // Set the Connection to the new OdbcConnection.
        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 OdbcConnection(connectionString)
        Dim command As New OdbcCommand()
        Dim transaction As OdbcTransaction

        ' Set the Connection to the new OdbcConnection.
        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

Pour valider ou restaurer la transaction, vous devez utiliser explicitement les Commit méthodes ou Rollback .

Pour vous assurer que le modèle de gestion des transactions du fournisseur de données .NET Framework pour ODBC 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