EntityConnection.BeginTransaction Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Begins a transaction by using the underlying provider.

Namespace:   System.Data.EntityClient
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public EntityTransaction BeginTransaction()

Return Value

Type: System.Data.EntityClient.EntityTransaction

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

Exception Condition

The underlying provider is not known.


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


The state of the EntityConnection is not Open.

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.

.NET Framework
Available since 3.5
Return to top