RelatedEnd.Load 方法

定義

命名空間:

System.Data.Objects.DataClasses

組件:

System.Data.Entity.dll

在衍生類別中覆寫時，將一個或多個相關物件載入本機集合或參考中。

多載

Load()	在衍生類別中覆寫時，使用預設合併選項，將一個或多個相關物件載入相關端中。
Load(MergeOption)	在衍生類別 (Derived Class) 中覆寫時，使用指定的合併選項，從相關端中載入一個或多個物件。

Load()

在衍生類別中覆寫時，使用預設合併選項，將一個或多個相關物件載入相關端中。

public:
 virtual void Load();

public void Load ();

abstract member Load : unit -> unit
override this.Load : unit -> unit

Public Sub Load ()

實作

Load()

例外狀況

InvalidOperationException

當來源物件是使用 NoTracking 查詢所擷取的，而且 MergeOption 不是 NoTracking 或者相關物件已經載入時。

-或-

當來源物件沒有附加至 ObjectContext 時。

-或-

當來源物件正在追蹤中，但是處於 Added 或 Deleted 狀態中，或者用於 MergeOption 的 Load() 是 NoTracking 時。

備註

預設合併選項為 AppendOnly (適用於追蹤的物件) 或 NoTracking (當物件並未在 ObjectStateManager 中追蹤時)。 若要指定 以外的AppendOnly合併選項，請在 上EntityCollection<TEntity>呼叫 Load 方法，或EntityReference<TEntity>採用特定MergeOption參數的 。

呼叫 方法會將 LoadIsLoaded 旗標設定為 true。

方法 Load 會從資料來源載入相關的物件，不論是否 IsLoaded 為 true。

Load(MergeOption)

在衍生類別 (Derived Class) 中覆寫時，使用指定的合併選項，從相關端中載入一個或多個物件。

public:
 abstract void Load(System::Data::Objects::MergeOption mergeOption);

public abstract void Load (System.Data.Objects.MergeOption mergeOption);

abstract member Load : System.Data.Objects.MergeOption -> unit

Public MustOverride Sub Load (mergeOption As MergeOption)

參數

mergeOption

MergeOption

將物件合併至現有的 MergeOption 時要使用的 EntityCollection<TEntity>。

實作

Load(MergeOption)

例外狀況

InvalidOperationException

當來源物件是使用 NoTracking 查詢所擷取的，而且 MergeOption 不是 NoTracking 或者相關物件已經載入時。

-或-

當來源物件沒有附加至 ObjectContext 時。

-或-

當來源物件正在追蹤中，但是處於 Added 或 Deleted 狀態中，或者用於 MergeOption 的 Load() 是 NoTracking 時。

備註

EntityCollection<TEntity> 和 EntityReference<TEntity> 都會覆寫這個方法來載入相關物件。 Load 呼叫 以從導覽屬性公開的相關端明確載入相關物件。 如需詳細資訊，請參閱載入相關物件。

呼叫 方法會將 LoadIsLoaded 旗標設定為 true。

方法 Load 會從資料來源載入相關的物件，不論是否 IsLoaded 為 true。

預設合併選項為 AppendOnly (適用於追蹤的物件) 或 NoTracking (當物件並未在 ObjectStateManager 中追蹤時)。