EntityConnection.BeginTransaction Method

Definition

Begins a database transaction.

Overloads

BeginTransaction()

Begins a transaction by using the underlying provider.

BeginTransaction(IsolationLevel)

Begins a transaction with the specified isolation level by using the underlying provider.

BeginTransaction()

Begins a transaction by using the underlying provider.

public:
 System::Data::EntityClient::EntityTransaction ^ BeginTransaction();
public System.Data.EntityClient.EntityTransaction BeginTransaction ();
override this.BeginTransaction : unit -> System.Data.EntityClient.EntityTransaction
Public Function BeginTransaction () As EntityTransaction

Returns

A new EntityTransaction. The returned EntityTransaction instance can later be associated with the EntityCommand to execute the command under that transaction.

Exceptions

The underlying provider is not known.

-or-

The call to BeginTransaction() was made on an EntityConnection that already has a current transaction.

-or-

The state of the EntityConnection is not Open.

Remarks

The BeginTransaction method uses the Unspecified transaction isolation level. To specify a different isolation level, call BeginTransaction. This value might be interpreted differently by different underlying providers. If you want your application to be portable across multiple providers, it should explicitly specify the transaction isolation level by calling BeginTransaction.

At any particular moment there can be no more than one active transaction that was created through BeginTransaction. An attempt to call any of the BeginTransaction overloads on an EntityConnection that already has a current transaction results in an InvalidOperationException.

Applies to

BeginTransaction(IsolationLevel)

Begins a transaction with the specified isolation level by using the underlying provider.

public:
 System::Data::EntityClient::EntityTransaction ^ BeginTransaction(System::Data::IsolationLevel isolationLevel);
public System.Data.EntityClient.EntityTransaction BeginTransaction (System.Data.IsolationLevel isolationLevel);
override this.BeginTransaction : System.Data.IsolationLevel -> System.Data.EntityClient.EntityTransaction
Public Function BeginTransaction (isolationLevel As IsolationLevel) As EntityTransaction

Parameters

isolationLevel
IsolationLevel

The isolation level of the transaction.

Returns

A new EntityTransaction. The returned EntityTransaction instance can later be associated with the EntityCommand to execute the command under that transaction.

Exceptions

The underlying provider is not known.

-or-

The call to BeginTransaction() was made on an EntityConnection that already has a current transaction.

-or-

The state of the EntityConnection is not Open.

Remarks

At any particular moment there can be no more than one active transaction that was created through BeginTransaction. An attempt to call any of the BeginTransaction overloads on an EntityConnection that already has a current transaction results in an InvalidOperationException.

Applies to