EntityCollection<TEntity> 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
一組建模特定 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
本收藏中的實體類型。
- 繼承
- 屬性
- 實作
建構函式
| 名稱 | 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) |