EntityReference 类

[本页针对的是实体框架版本 6。最新版本以“实体框架”NuGet 包的形式提供。有关实体框架的更多信息，请参见 msdn.com/data/ef。]

对多重性为 1 的关系端进行建模。

继承层次结构

System.Object
  System.Data.Entity.Core.Objects.DataClasses.RelatedEnd
    System.Data.Entity.Core.Objects.DataClasses.EntityReference
      System.Data.Entity.Core.Objects.DataClasses.EntityReference<TEntity>

命名空间：  System.Data.Entity.Core.Objects.DataClasses
程序集：  EntityFramework（在 EntityFramework.dll 中）

语法

声明
<SerializableAttribute> _
<DataContractAttribute> _
Public MustInherit Class EntityReference _
    Inherits RelatedEnd
用法
Dim instance As EntityReference

[SerializableAttribute]
[DataContractAttribute]
public abstract class EntityReference : RelatedEnd

[SerializableAttribute]
[DataContractAttribute]
public ref class EntityReference abstract : public RelatedEnd

[<AbstractClassAttribute>]
[<SerializableAttribute>]
[<DataContractAttribute>]
type EntityReference =  
    class 
        inherit RelatedEnd 
    end

public abstract class EntityReference extends RelatedEnd

EntityReference 类型公开以下成员。

属性

	名称	描述
	EntityKey	返回相关对象的键。
	IsLoaded	获取一个值，该值指示是否已加载所有相关对象。 （继承自 RelatedEnd。）
	RelationshipName	获取此相关端所参与的关系的名称。 （继承自 RelatedEnd。）
	RelationshipSet	获取对相关端的元数据的引用。 （继承自 RelatedEnd。）
	SourceRoleName	获取关系的源端的角色名称。 （继承自 RelatedEnd。）
	TargetRoleName	获取关系的目标端的角色名称。 （继承自 RelatedEnd。）

顶部

方法

	名称	描述
	Equals	（继承自 Object。）
	Finalize	（继承自 Object。）
	GetEnumerator	返回一个 IEnumerator，它循环访问相关对象的集合。 （继承自 RelatedEnd。）
	GetHashCode	（继承自 Object。）
	GetType	（继承自 Object。）
	Load()	使用默认合并选项将一个或多个相关对象加载到相关端中。 （继承自 RelatedEnd。）
	Load(MergeOption)	使用指定合并选项从相关端加载一个或多个对象。 （继承自 RelatedEnd。）
	LoadAsync(CancellationToken)	使用默认合并选项将一个或多个相关对象异步加载到相关端中。 （继承自 RelatedEnd。）
	LoadAsync(MergeOption, CancellationToken)	使用指定合并选项从相关端异步加载一个或多个对象。 （继承自 RelatedEnd。）
	MemberwiseClone	（继承自 Object。）
	OnDeserialized	在内部使用，用于反序列化实体对象及 RelationshipManager 实例。 （继承自 RelatedEnd。）
	ToString	（继承自 Object。）

顶部

事件

	名称	描述
	AssociationChanged	对相关端进行更改时发生。 （继承自 RelatedEnd。）

顶部

显式接口实现  

	名称	描述
	IRelatedEnd.Add(Object)	将实体添加到相关端。如果所有者附加到某一缓存，则所有连接端都添加到该对象缓存，并且其对应关系也添加到 ObjectStateManager。关系的 RelatedEnd 也是固定的。 （继承自 RelatedEnd。）
	IRelatedEnd.Add(IEntityWithRelationships)	将实体添加到相关端。此方法与 Add(object) 的工作方式完全相同。保留此方法是为了与以前版本的 IRelatedEnd 向后兼容。 （继承自 RelatedEnd。）
	IRelatedEnd.Attach(Object)	将实体附加到相关端。如果相关端已经填充或部分填充，则此操作将合并现有实体和给定实体。不假定给定实体为相关实体的完整集。所有者和所有传入的实体必须处于 Unchanged 或 Modified 状态。仅当状态管理器已在跟踪关系实例时，才允许已删除的元素。 （继承自 RelatedEnd。）
	IRelatedEnd.Attach(IEntityWithRelationships)	将实体附加到相关端。此方法与 Attach(object) 的工作方式完全相同。保留此方法是为了与以前版本的 IRelatedEnd 向后兼容。 （继承自 RelatedEnd。）
	IRelatedEnd.CreateSourceQuery	返回一个 IEnumerable，它表示属于相关端的对象。 （继承自 RelatedEnd。）
	IRelatedEnd.Remove(Object)	从相关端删除实体。如果所有者附加到缓存，则将关系标记为待删除；如果关系是复合关系，也将实体标记为待删除。 （继承自 RelatedEnd。）
	IRelatedEnd.Remove(IEntityWithRelationships)	从相关端删除实体。此方法与 Remove(object) 的工作方式完全相同。保留此方法是为了与以前版本的 IRelatedEnd 向后兼容。 （继承自 RelatedEnd。）

顶部

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参阅

参考

System.Data.Entity.Core.Objects.DataClasses 命名空间