EntityReference<TEntity> 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
建模關係以多重性結束 1。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
[System.Runtime.Serialization.DataContract]
[System.Serializable]
public class EntityReference<TEntity> : System.Data.Entity.Core.Objects.DataClasses.EntityReference where TEntity : class
type EntityReference<'Entity (requires 'Entity : null)> = class
inherit EntityReference
Public Class EntityReference(Of TEntity)
Inherits EntityReference
類型參數
- TEntity
所參考實體的類型。
- 繼承
- 屬性
建構函式
| 名稱 | Description |
|---|---|
| EntityReference<TEntity>() |
建立一個新的 實例。EntityReference<TEntity> |
屬性
| 名稱 | Description |
|---|---|
| EntityKey |
回傳相關物件的金鑰。 (繼承來源 EntityReference) |
| IsLoaded |
取得或設定一個值,表示該實體(對於集合 EntityReference 中或所有實體,對於 ) EntityCollection<TEntity> 是否已從資料庫載入。 (繼承來源 RelatedEnd) |
| RelationshipName |
取得該相關端參與的關係名稱。 (繼承來源 RelatedEnd) |
| RelationshipSet |
會取得相關端的元資料參考。 (繼承來源 RelatedEnd) |
| SourceRoleName |
在關係的原始端取得角色名稱。 (繼承來源 RelatedEnd) |
| TargetRoleName |
在關係的目標端取得角色名稱。 (繼承來源 RelatedEnd) |
| Value |
取得或設定由此 EntityReference<TEntity> 回傳的相關物件。 |
方法
| 名稱 | Description |
|---|---|
| Attach(TEntity) |
在物件情境中,建立多對一或一對一的關係。 |
| CreateSourceQuery() |
建立一個等價的物件查詢,回傳相關物件。 |
| GetEnumerator() |
回傳 和 IEnumerator ,會遍歷相關物件的集合。 (繼承來源 RelatedEnd) |
| Load() |
用預設合併選項將相關物件載入相關端。 (繼承來源 RelatedEnd) |
| Load(MergeOption) |
載入相關物件 EntityReference<TEntity> 並使用指定的合併選項。 |
| LoadAsync(CancellationToken) |
非同步地將相關物件載入相關端,並使用預設的合併選項。 (繼承來源 RelatedEnd) |
| LoadAsync(MergeOption, CancellationToken) |
非同步地從相關端以指定的合併選項載入物件或物件。 |
| OnDeserialized(StreamingContext) |
內部用於將實體物件與 RelationshipManager 實例一同反序列化。 (繼承來源 RelatedEnd) |
| OnRefDeserialized(StreamingContext) |
此方法在內部用於序列化相關的實體物件。 |
| OnSerializing(StreamingContext) |
此方法在內部用於序列化相關的實體物件。 |
事件
| 名稱 | Description |
|---|---|
| AssociationChanged |
當變更發生在相關目的時。 (繼承來源 RelatedEnd) |
明確介面實作
| 名稱 | Description |
|---|---|
| IRelatedEnd.Add(IEntityWithRelationships) |
在相關端新增一個實體。 此方法的運作方式與 Add(物件)完全相同。 它是為了向下相容於先前版本的 IRelatedEnd。 (繼承來源 RelatedEnd) |
| IRelatedEnd.Add(Object) |
在相關端新增一個實體。 如果擁有者連接到快取,則所有連接端會被加入物件快取,對應的關聯也會加入 ObjectStateManager。 關係的 RelatedEnd 也是固定的。 (繼承來源 RelatedEnd) |
| IRelatedEnd.Attach(IEntityWithRelationships) |
將實體附加到相關端端。 此方法的運作方式與 Attach(物件)完全相同。 它是為了向下相容於先前版本的 IRelatedEnd。 (繼承來源 RelatedEnd) |
| IRelatedEnd.Attach(Object) |
將實體附加到相關端端。 若相關端已填滿或部分填滿,則將現有實體與該實體合併。 所給實體並不被視為所有相關實體的完整集合。 所有權人及所有被繼承的實體必須處於未變更或修改狀態。 刪除元素僅允許在狀態管理器已追蹤關係實例時。 (繼承來源 RelatedEnd) |
| IRelatedEnd.CreateSourceQuery() |
回傳 和 IEnumerable ,代表屬於相關端點的物件。 (繼承來源 RelatedEnd) |
| IRelatedEnd.Remove(IEntityWithRelationships) |
從相關端移除實體。 此方法的運作方式與 Remove(object) 完全相同。 它是為了向下相容於先前版本的 IRelatedEnd。 (繼承來源 RelatedEnd) |
| IRelatedEnd.Remove(Object) |
從相關端移除實體。 如果擁有者連結到快取,則標記關聯可刪除;若關係為組合,則標記該實體可刪除。 (繼承來源 RelatedEnd) |