RelatedEnd.Load メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされた場合は、関連するオブジェクトをローカル コレクションまたは参照に読み込みます。
オーバーロード
| 名前 | 説明 |
|---|---|
| Load() |
派生クラスでオーバーライドされた場合は、既定のマージ オプションを使用して、関連するオブジェクトを関連する末尾に読み込みます。 |
| Load(MergeOption) |
派生クラスでオーバーライドされた場合は、指定したマージ オプションを使用して、関連する末尾からオブジェクトを読み込みます。 |
Load()
派生クラスでオーバーライドされた場合は、既定のマージ オプションを使用して、関連するオブジェクトを関連する末尾に読み込みます。
public:
virtual void Load();
public void Load();
abstract member Load : unit -> unit
override this.Load : unit -> unit
Public Sub Load ()
実装
例外
NoTracking クエリを使用してソース オブジェクトが取得され、MergeOptionがNoTrackingされていないか、関連オブジェクトが既に読み込まれている場合。
-又は-
ソース オブジェクトが ObjectContextにアタッチされていない場合。
-又は-
ソース オブジェクトが追跡されているが、AddedまたはDeleted状態にある場合、またはMergeOptionに使用されるLoad()がNoTracking場合。
注釈
既定のマージ オプションは、追跡対象のオブジェクトに対してAppendOnlyされるか、オブジェクトがNoTrackingで追跡されていない場合にObjectStateManagerされます。
AppendOnly以外のマージ オプションを指定するには、特定のLoad パラメーターを受け取るEntityCollection<TEntity>またはEntityReference<TEntity>でMergeOption メソッドを呼び出します。
Load メソッドを呼び出すと、IsLoaded フラグがtrueに設定されます。
Load メソッドは、IsLoadedがtrueされているかどうかに関係なく、データ ソースから関連オブジェクトを読み込みます。
適用対象
Load(MergeOption)
派生クラスでオーバーライドされた場合は、指定したマージ オプションを使用して、関連する末尾からオブジェクトを読み込みます。
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>。
実装
例外
NoTracking クエリを使用してソース オブジェクトが取得され、MergeOptionがNoTrackingされていないか、関連オブジェクトが既に読み込まれている場合。
-又は-
ソース オブジェクトが ObjectContextにアタッチされていない場合。
-又は-
ソース オブジェクトが追跡されているが、AddedまたはDeleted状態にある場合、またはMergeOptionに使用されるLoad()がNoTracking場合。
注釈
EntityCollection<TEntity>とEntityReference<TEntity>の両方で、このメソッドをオーバーライドして関連オブジェクトを読み込みます。
Load は、ナビゲーション プロパティによって公開される関連するエンドから関連オブジェクトを明示的に読み込む場合に呼び出されます。 詳細については、「 関連オブジェクトの読み込み」を参照してください。
Load メソッドを呼び出すと、IsLoaded フラグがtrueに設定されます。
Load メソッドは、IsLoadedがtrueされているかどうかに関係なく、データ ソースから関連オブジェクトを読み込みます。
既定のマージ オプションは、追跡対象のオブジェクトに対してAppendOnlyされるか、オブジェクトがNoTrackingで追跡されていない場合にObjectStateManagerされます。