OleDbConnection.BeginTransaction Метод

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v8.0.0

Начинает транзакцию базы данных.

Перегрузки

BeginTransaction()	Запускает транзакцию базы данных с текущим значением IsolationLevel.
BeginTransaction(IsolationLevel)	Начинает транзакцию базы данных с указанным уровнем изоляции.

BeginTransaction()

Исходный код:

OleDbConnection.cs

Запускает транзакцию базы данных с текущим значением 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

Возвращаемое значение

OleDbTransaction

Объект, представляющий новую транзакцию.

Исключения

InvalidOperationException

Параллельные транзакции не поддерживаются.

Примеры

В следующем примере создаются OleDbConnection и OleDbTransaction. В ней также показано, как использовать методы BeginTransaction, Commitи Rollback .

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

Комментарии

Должны быть явным образом произведены фиксация или откат транзакции методом Commit или Rollback. Чтобы убедиться, что поставщик данных платформа .NET Framework для модели управления транзакциями OLE DB работает правильно, избегайте использования других моделей управления транзакциями, таких как модели, предоставляемые источником данных.

См. также раздел

• Подключение к источникам данных

BeginTransaction(IsolationLevel)

Исходный код:

OleDbConnection.cs

Начинает транзакцию базы данных с указанным уровнем изоляции.

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

Параметры

isolationLevel

IsolationLevel

Уровень изоляции, с которым должна выполняться транзакция.

Возвращаемое значение

OleDbTransaction

Объект, представляющий новую транзакцию.

Исключения

InvalidOperationException

Параллельные транзакции не поддерживаются.

Примеры

В следующем примере создаются OleDbConnection и OleDbTransaction. Здесь также показано, как использовать методы BeginTransaction, Commitи Rollback .

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

Комментарии

Должны быть явным образом произведены фиксация или откат транзакции методом Commit или Rollback. Чтобы убедиться, что поставщик данных платформа .NET Framework для модели управления транзакциями OLE DB работает правильно, избегайте использования других моделей управления транзакциями, таких как модели, предоставляемые источником данных.

Примечание

Если уровень изоляции не указан, используется уровень изоляции по умолчанию для базового поставщика. Чтобы указать уровень изоляции BeginTransaction с помощью метода , используйте перегрузку, которая принимает isolationLevel параметр .

См. также раздел

• Подключение к источникам данных