Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ObjectContext.Translate(Of TEntity) Method (DbDataReader, String, MergeOption)

Translates a DbDataReader that contains rows of entity data to objects of the requested entity type, in a specific entity set, and with the specified merge option.

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

'Declaration
Public Function Translate(Of TEntity) ( _
	reader As DbDataReader, _
	entitySetName As String, _
	mergeOption As MergeOption _
) As ObjectResult(Of TEntity)

Type Parameters

TEntity

Parameters

reader
Type: System.Data.Common.DbDataReader
The DbDataReader that contains entity data to translate into entity objects.
entitySetName
Type: System.String
The entity set of the TResult type.
mergeOption
Type: System.Data.Objects.MergeOption
The MergeOption to use when translated objects are added to the object context. The default is AppendOnly.

Return Value

Type: System.Data.Objects.ObjectResult(Of TEntity)
An enumeration of objects of type TResult.

ExceptionCondition
ArgumentNullException

When reader is Nothing.

ArgumentOutOfRangeException

When the supplied mergeOption is not a valid MergeOption value.

InvalidOperationException

When the supplied entitySetName is not a valid entity set for the TResult type.

The Translate method is used to translate entity data from a DbDataReader into objects of the requested type. This process is performed automatically when an ObjectQuery(Of T) is executed to return entity data. The Translate method enables you to execute a standard ADO.NET query against a data source and translate the returned data rows into entity objects.

The supplied DbDataReader must contain data that maps to the requested entity type.

For more information, see:

Executing Store Commands and

How to: Directly Execute Arbitrary Command Against the Store

.NET Framework

Supported in: 4

.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.

Community Additions

ADD
Show:
© 2015 Microsoft