EntityReference<TEntity>.Load(MergeOption) メソッド

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

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

override this.Load : System.Data.Objects.MergeOption -> unit

Public Overrides Sub Load (mergeOption As MergeOption)

パラメーター

例外

注釈

このメソッドは、関連オブジェクトを読み込むために使用されます。

読み込まれた関連オブジェクトには、Value プロパティからアクセスします。

関連オブジェクトを明示的に読み込むには、ナビゲーション プロパティによって返される関連する末尾で メソッドを呼び出す Load 必要があります。 一対多のリレーションシップの場合は、Load に対して EntityCollection<TEntity> メソッドを呼び出します。一対一のリレーションシップの場合は、Load に対して EntityReference<TEntity> を呼び出します。 これにより、関連オブジェクト データがオブジェクト コンテキストに読み込まれます。 クエリが結果を返すときは、ループ (For Each...NextVisual Basic では) を使用してforeachオブジェクトのコレクションを列挙し、結果内の各エンティティの および プロパティに対EntityReference<TEntity>して メソッドと EntityCollection<TEntity> プロパティを条件付きで呼び出Loadすことができます。

メソッドはLoad、 が であるかどうかにかかわらずIsLoadedtrue、データ ソースから関連オブジェクトを読み込みます。

このメソッドは、関連オブジェクトを読み込む前に内部 RelatedEnd.ValidateLoad メソッドを呼び出します。これにより、 の Load 呼び出しが正しい条件を持っていることを検証します。 メソッドでは RelatedEnd.ValidateLoad 、次のことが確認されます。

• 有効な ObjectContext が存在します。
• エンティティが状態ではありません Deleted 。
• MergeOptionはLoad、ソース エンティティが のNoTracking場合にのみ であるNoTracking必要があります。 ソース エンティティが他 MergeOptionの を使用して取得された場合は、 LoadMergeOption 以外 NoTracking の任意の値を指定できます (たとえば、エンティティは で OverwriteChanges 読み込まれ、オプションは Load にできます AppendOnly)。
• が の場合mergeOption、 は既に読み込まれているエンティティLoadでは呼び出されず、空でない追跡されていない では呼び出されませんRelatedEnd。 LoadNoTracking

関連オブジェクトが に既にObjectContext読み込まれている場合、 メソッドは Load パラメーターで指定された をMergeOptionmergeOption適用します。 詳しくは、「ID 解決、状態管理、および変更の追跡」をご覧ください。

適用対象

こちらもご覧ください

• オブジェクトとしてのデータのクエリ (Entity Framework)