語言

EntityCollection<TEntity> 類別

定義

一組建模特定 EDM 結構的實體集合,這些實體可以是特定類型的所有實體,或是參與特定關係的實體。

[System.Serializable]
public class EntityCollection<TEntity> : System.Data.Entity.Core.Objects.DataClasses.RelatedEnd, System.Collections.Generic.ICollection<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource where TEntity : class
type EntityCollection<'Entity (requires 'Entity : null)> = class
    inherit RelatedEnd
    interface ICollection<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface IListSource
Public Class EntityCollection(Of TEntity)
Inherits RelatedEnd
Implements ICollection(Of TEntity), IEnumerable(Of TEntity), IListSource

類型參數

TEntity

本收藏中的實體類型。

繼承
EntityCollection<TEntity>
屬性
實作

建構函式

名稱 Description
EntityCollection<TEntity>()

初始化 EntityCollection<TEntity> 類別的新執行個體。

屬性

名稱 Description
Count

取得集合中包含的物件數量。

IsLoaded

取得或設定一個值,表示該實體(對於集合 EntityReference 中或所有實體,對於 ) EntityCollection<TEntity> 是否已從資料庫載入。

(繼承來源 RelatedEnd)
IsReadOnly

取得值,這個值表示 EntityCollection<TEntity> 是否為唯讀。

RelationshipName

取得該相關端參與的關係名稱。

(繼承來源 RelatedEnd)
RelationshipSet

會取得相關端的元資料參考。

(繼承來源 RelatedEnd)
SourceRoleName

在關係的原始端取得角色名稱。

(繼承來源 RelatedEnd)
TargetRoleName

在關係的目標端取得角色名稱。

(繼承來源 RelatedEnd)

方法

名稱 Description
Add(TEntity)

將物件加入至集合。

Attach(IEnumerable<TEntity>)

定義物件與物件相關物件集合在物件語境中的關係。

Attach(TEntity)

定義兩個相連物體在物件語境中的關係。

Clear()

將所有實體從集合中移除。

Contains(TEntity)

判斷集合中是否存在特定物件。

CopyTo(TEntity[], Int32)

將集合中的所有內容從目標陣列指定的索引開始複製到陣列。

CreateSourceQuery()

回傳一個物件查詢,執行時會回傳與目前集合中相同的物件集合。

GetEnumerator()

回傳一個枚舉器,用於遍歷集合中的物件。

Load()

用預設合併選項將相關物件載入相關端。

(繼承來源 RelatedEnd)
Load(MergeOption)

透過指定的合併選項將相關物件載入集合。

LoadAsync(CancellationToken)

非同步地將相關物件載入相關端,並使用預設的合併選項。

(繼承來源 RelatedEnd)
LoadAsync(MergeOption, CancellationToken)

非同步地從相關端以指定的合併選項載入物件或物件。

OnCollectionDeserialized(StreamingContext)

內部用於反序列化實體物件。

OnDeserialized(StreamingContext)

內部用於將實體物件與 RelationshipManager 實例一同反序列化。

(繼承來源 RelatedEnd)
OnSerializing(StreamingContext)

內部用於序列化實體物件。

Remove(TEntity)

從集合中移除物件並標記該關聯以供刪除。

事件

名稱 Description
AssociationChanged

當變更發生在相關目的時。

(繼承來源 RelatedEnd)

明確介面實作

名稱 Description
IEnumerable.GetEnumerator()

回傳一個枚舉子,用來遍歷由 EntityCollection<TEntity> 快取的值集合。

IListSource.ContainsListCollection

IListSource.ContainsListCollection 實作。 總是回傳 false。 這表示我們回傳的 IList 是包含實際資料的那個,而不是集合清單。

IListSource.GetList()

將集合作為 IList 資料綁定的使用資料。

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)

適用於