OdbcConnection.BeginTransaction Método

Definição

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacote:

System.Data.Odbc v8.0.0

Inicia uma transação na fonte de dados.

Sobrecargas

BeginTransaction()	Inicia uma transação na fonte de dados.
BeginTransaction(IsolationLevel)	Inicia uma transação na fonte de dados com o valor IsolationLevel especificado.

BeginTransaction()

Origem:

OdbcConnection.cs

Inicia uma transação na fonte de dados.

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

Retornos

OdbcTransaction

Um objeto que representa a nova transação.

Exceções

InvalidOperationException

Uma transação está ativa no momento. Não há suporte para transações paralelas.

Exemplos

O exemplo a seguir cria um OdbcConnection e um OdbcTransaction. Ele também demonstra como usar os BeginTransactionmétodos , Commite 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

Comentários

Para confirmar ou reverter a transação, você deve usar explicitamente os Commit métodos ou Rollback .

Para garantir que o provedor de dados .NET Framework para o modelo de gerenciamento de transações ODBC seja executado corretamente, evite usar outros modelos de gerenciamento de transações, como os fornecidos pela fonte de dados.

Observação

Se você não especificar um nível de isolamento, o nível de isolamento será determinado pelo driver que está sendo usado. Para especificar um nível de isolamento com o BeginTransaction método , use a sobrecarga que usa o isolevel parâmetro .

Confira também

• Conectando-se a fontes de dados

BeginTransaction(IsolationLevel)

Origem:

OdbcConnection.cs

Inicia uma transação na fonte de dados com o valor IsolationLevel especificado.

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

Parâmetros

isolevel

IsolationLevel

O nível de isolamento da transação desta conexão. Se você não especificar um nível de isolamento, o nível de isolamento padrão do driver será usado.

Retornos

OdbcTransaction

Um objeto que representa a nova transação.

Exceções

InvalidOperationException

Uma transação está ativa no momento. Não há suporte para transações paralelas.

Exemplos

O exemplo a seguir cria um OdbcConnection e um OdbcTransaction. Ele também demonstra como usar os BeginTransactionmétodos , Commite 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

Comentários

Para confirmar ou reverter a transação, você deve usar explicitamente os Commit métodos ou Rollback .

Para garantir que o provedor de dados .NET Framework para o modelo de gerenciamento de transações ODBC seja executado corretamente, evite usar outros modelos de gerenciamento de transações, como os fornecidos pela fonte de dados.

Confira também

• Conectando-se a fontes de dados