EntityReference Class

Reference

Definition

Namespace:: System.Data.Entity.Core.Objects.DataClasses

Assembly:: EntityFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Models a relationship end with multiplicity 1.

[System.Runtime.Serialization.DataContract]
[System.Serializable]
public abstract class EntityReference : System.Data.Entity.Core.Objects.DataClasses.RelatedEnd

type EntityReference = class
    inherit RelatedEnd

Public MustInherit Class EntityReference
Inherits RelatedEnd

Inheritance: Object

RelatedEnd
EntityReference

Derived: System.Data.Entity.Core.Objects.DataClasses.EntityReference<TEntity>

Attributes: DataContractAttribute SerializableAttribute

Properties

EntityKey	Returns the key for the related object.
IsLoaded	Gets or sets a value indicating whether the entity (for an EntityReference or all entities in the collection (for an EntityCollection<TEntity> have been loaded from the database. (Inherited from RelatedEnd)
RelationshipName	Gets the name of the relationship in which this related end participates. (Inherited from RelatedEnd)
RelationshipSet	Gets a reference to the metadata for the related end. (Inherited from RelatedEnd)
SourceRoleName	Gets the role name at the source end of the relationship. (Inherited from RelatedEnd)
TargetRoleName	Gets the role name at the target end of the relationship. (Inherited from RelatedEnd)

Methods

GetEnumerator()	Returns an IEnumerator that iterates through the collection of related objects. (Inherited from RelatedEnd)
Load()	Loads the related object or objects into the related end with the default merge option. (Inherited from RelatedEnd)
Load(MergeOption)	Loads an object or objects from the related end with the specified merge option. (Inherited from RelatedEnd)
LoadAsync(CancellationToken)	Asynchronously loads the related object or objects into the related end with the default merge option. (Inherited from RelatedEnd)
LoadAsync(MergeOption, CancellationToken)	Asynchronously loads an object or objects from the related end with the specified merge option. (Inherited from RelatedEnd)
OnDeserialized(StreamingContext)	Used internally to deserialize entity objects along with the RelationshipManager instances. (Inherited from RelatedEnd)

Events

AssociationChanged

Occurs when a change is made to a related end.

(Inherited from RelatedEnd)

Explicit Interface Implementations

IRelatedEnd.Add(IEntityWithRelationships)	Adds an entity to the related end. This method works in exactly the same way as Add(object). It is maintained for backward compatibility with previous versions of IRelatedEnd. (Inherited from RelatedEnd)
IRelatedEnd.Add(Object)	Adds an entity to the related end. If the owner is attached to a cache then the all the connected ends are added to the object cache and their corresponding relationships are also added to the ObjectStateManager. The RelatedEnd of the relationship is also fixed. (Inherited from RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)	Attaches an entity to the related end. This method works in exactly the same way as Attach(object). It is maintained for backward compatibility with previous versions of IRelatedEnd. (Inherited from RelatedEnd)
IRelatedEnd.Attach(Object)	Attaches an entity to the related end. If the related end is already filled or partially filled, this merges the existing entities with the given entity. The given entity is not assumed to be the complete set of related entities. Owner and all entities passed in must be in Unchanged or Modified state. Deleted elements are allowed only when the state manager is already tracking the relationship instance. (Inherited from RelatedEnd)
IRelatedEnd.CreateSourceQuery()	Returns an IEnumerable that represents the objects that belong to the related end. (Inherited from RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)	Removes an entity from the related end. This method works in exactly the same way as Remove(object). It is maintained for backward compatibility with previous versions of IRelatedEnd. (Inherited from RelatedEnd)
IRelatedEnd.Remove(Object)	Removes an entity from the related end. If owner is attached to a cache, marks relationship for deletion and if the relationship is composition also marks the entity for deletion. (Inherited from RelatedEnd)

Applies to