EntityReference<TEntity> 類別

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊，請參閱 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> _
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class EntityReference(Of TEntity As Class) _
    Inherits EntityReference
'用途
Dim instance As EntityReference(Of TEntity)

[SerializableAttribute]
[DataContractAttribute]
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class EntityReference<TEntity> : EntityReference 
where TEntity : class

[SerializableAttribute]
[DataContractAttribute]
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TEntity>
where TEntity : ref class 
public ref class EntityReference : public EntityReference

[<SerializableAttribute>]
[<DataContractAttribute>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type EntityReference<'TEntity when 'TEntity : not struct> =  
    class 
        inherit EntityReference 
    end

JScript does not support generic types and methods.

類型參數

• TEntity
  正在參考之實體的類型。

EntityReference<TEntity> 類型會公開下列成員。

建構函式

	名稱	描述
	EntityReference<TEntity>	建立 EntityReference<TEntity> 的新執行個體。

靠上

屬性

	名稱	描述
	EntityKey	傳回相關物件的索引鍵。 (繼承自 EntityReference)。
	IsLoaded	取得值，此值指出所有相關物件是否都已經載入。 (繼承自 RelatedEnd)。
	RelationshipName	取得此相關端所參與之關聯性的名稱。 (繼承自 RelatedEnd)。
	RelationshipSet	取得相關端中繼資料的參考。 (繼承自 RelatedEnd)。
	SourceRoleName	取得位於關聯性來源端的角色名稱。 (繼承自 RelatedEnd)。
	TargetRoleName	取得位於關聯性目標端的角色名稱。 (繼承自 RelatedEnd)。
	Value	取得或設定此 EntityReference<TEntity> 所傳回的相關物件。

靠上

方法

	名稱	描述
	Attach	在物件內容中，建立兩個物件之間的多對一或一對一關聯性。
	CreateSourceQuery	建立傳回相關物件的對等物件查詢。
	Equals	(繼承自 Object)。
	Finalize	(繼承自 Object)。
	GetEnumerator	傳回 IEnumerator，它會逐一查看相關物件的集合。 (繼承自 RelatedEnd)。
	GetHashCode	(繼承自 Object)。
	GetType	(繼承自 Object)。
	Load()	使用預設合併選項，將一個或多個相關物件載入相關端中。 (繼承自 RelatedEnd)。
	Load(MergeOption)	使用指定的合併選項，載入此 EntityReference<TEntity> 的相關物件。 (覆寫 RelatedEnd.Load(MergeOption)。)
	LoadAsync(CancellationToken)	使用預設合併選項，以非同步方式將一個或多個相關物件載入相關端中。 (繼承自 RelatedEnd)。
	LoadAsync(MergeOption, CancellationToken)	使用預設的合併選項，以非同步方式將一個或多個相關實體載入相關端。 (覆寫 RelatedEnd.LoadAsync(MergeOption, CancellationToken)。)
	MemberwiseClone	(繼承自 Object)。
	OnDeserialized	在內部搭配 RelationshipManager 執行個體用來還原序列化實體物件。 (繼承自 RelatedEnd)。
	OnRefDeserialized	此方法是在內部用來序列化相關實體物件。
	OnSerializing	此方法是在內部用來序列化相關實體物件。
	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)。

靠上

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

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