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

DbExpressionBuilder.CreateRef Method (EntitySet, EntityType, DbExpression[])

.NET Framework 4.6 and 4.5

Creates a new DbRefExpression that encodes a reference to a specific entity of a given type based on key values.

Namespace:  System.Data.Common.CommandTrees.ExpressionBuilder
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public static DbRefExpression CreateRef(
	this EntitySet entitySet,
	EntityType entityType,
	params DbExpression[] keyValues


Type: System.Data.Metadata.Edm.EntitySet

The entity set in which the referenced element resides.

Type: System.Data.Metadata.Edm.EntityType

The specific type of the referenced entity. This must be an entity type from the same hierarchy as the entity set's element type.

Type: System.Data.Common.CommandTrees.DbExpression[]

A collection of DbExpressions that provide the key values. These expressions must match (in number, type, and order) the key properties of the referenced entity type.

Return Value

Type: System.Data.Common.CommandTrees.DbRefExpression
A new DbRefExpression that references the element with the specified key values in the given entity set.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type EntitySet. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).


entitySet or entityType is null, or keyValues is null or contains null.


entityType is not from the same type hierarchy (a subtype, supertype, or the same type) as entitySet's element type.


The count of keyValues does not match the count of key members declared by the entitySet’s element type, or keyValues contains an expression with a result type that is not compatible with the type of the corresponding key member.

.NET Framework

Supported in: 4.6, 4.5
© 2015 Microsoft