This documentation is archived and is not being maintained.

EntityConnection.BeginTransaction Method

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.

ExceptionCondition
InvalidOperationException

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.

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

Supported in: 4, 3.5 SP1

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: