ObjectContext.LoadProperty メソッド

定義

名前空間:

System.Data.Objects

アセンブリ:

System.Data.Entity.dll

POCO カスタム データ クラスを使用している場合に、関連オブジェクトを明示的に読み込みます。

オーバーロード

LoadProperty(Object, String)	指定したナビゲーション プロパティと既定のマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。
LoadProperty(Object, String, MergeOption)	指定したナビゲーション プロパティと指定したマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	指定した LINQ クエリと指定したマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	指定した LINQ クエリと既定のマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。

注釈

POCO カスタム データ クラスを使用する場合、Entity Data Model ツールによって生成されるエンティティ型のインスタンスのように、関連オブジェクトを明示的に読み込むことはできません。 これは、 で が呼び出されたときにLoad、 または EntityReference<TEntity> 関連オブジェクトを返すEntityCollection<TEntity>ナビゲーション プロパティがツールによってRelatedEnd生成されるためです。 遅延読み込みを使用して POCO エンティティを読み込むには、 LazyLoadingEnabledObjectContext.ContextOptionsプロパティにtrueよって返されるObjectContextOptionsのインスタンスでプロパティをに設定するか、またはのIncludeメソッドを使用して一括読み込みを使用しますObjectQuery<T>。

LoadProperty(Object, String)

指定したナビゲーション プロパティと既定のマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。

public:
 void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty);

public void LoadProperty (object entity, string navigationProperty);

member this.LoadProperty : obj * string -> unit

Public Sub LoadProperty (entity As Object, navigationProperty As String)

パラメーター

entity

Object

関連オブジェクトを読み込むエンティティ。

navigationProperty

String

読み込む関連オブジェクトを返すナビゲーション プロパティの名前。

例外

InvalidOperationException

entity が Detached、 Added または Deleted 状態にある場合。

- または -

entity が ObjectContext の他のインスタンスにアタッチされていない場合。

注釈

LoadProperty POCO カスタム データ クラスを使用しているときに明示的な読み込みを実現するには、 メソッドを呼び出す必要があります。

を呼び出 LoadPropertyした後、ソース エンティティのナビゲーション プロパティを介して関連オブジェクトにアクセスできます。

POCO カスタム データ クラスを使用する場合、Entity Data Model ツールによって生成されるエンティティ型のインスタンスのように、関連オブジェクトを明示的に読み込むことはできません。 これは、 で が呼び出されたときにLoad、 または EntityReference<TEntity> 関連オブジェクトを返すEntityCollection<TEntity>ナビゲーション プロパティがツールによってRelatedEnd生成されるためです。 遅延読み込みを使用して POCO エンティティを読み込むには、 LazyLoadingEnabledObjectContext.ContextOptionsプロパティにtrueよって返されるObjectContextOptionsのインスタンスでプロパティをに設定するか、またはのIncludeメソッドを使用して一括読み込みを使用しますObjectQuery<T>。

メソッドがLoadProperty呼び出されると、 の既定値MergeOptionAppendOnlyを使用して オブジェクトが に読み込ObjectContextまれます。

LoadProperty(Object, String, MergeOption)

指定したナビゲーション プロパティと指定したマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。

public:
 void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty, System::Data::Objects::MergeOption mergeOption);

public void LoadProperty (object entity, string navigationProperty, System.Data.Objects.MergeOption mergeOption);

member this.LoadProperty : obj * string * System.Data.Objects.MergeOption -> unit

Public Sub LoadProperty (entity As Object, navigationProperty As String, mergeOption As MergeOption)

パラメーター

entity

Object

関連オブジェクトを読み込むエンティティ。

navigationProperty

String

読み込む関連オブジェクトを返すナビゲーション プロパティの名前。

mergeOption

MergeOption

関連オブジェクトの読み込み時に使用する MergeOption 値。

例外

InvalidOperationException

entity が Detached、 Added または Deleted 状態にある場合。

- または -

entity が ObjectContext の他のインスタンスにアタッチされていない場合。

注釈

LoadProperty POCO カスタム データ クラスを使用しているときに明示的な読み込みを実現するには、 メソッドを呼び出す必要があります。

を呼び出 LoadPropertyした後、ソース エンティティのナビゲーション プロパティを介して関連オブジェクトにアクセスできます。

POCO カスタム データ クラスを使用する場合、Entity Data Model ツールによって生成されるエンティティ型のインスタンスのように、関連オブジェクトを明示的に読み込むことはできません。 これは、 で が呼び出されたときにLoad、 または EntityReference<TEntity> 関連オブジェクトを返すEntityCollection<TEntity>ナビゲーション プロパティがツールによってRelatedEnd生成されるためです。 遅延読み込みを使用して POCO エンティティを読み込むには、 LazyLoadingEnabledObjectContext.ContextOptionsプロパティにtrueよって返されるObjectContextOptionsのインスタンスでプロパティをに設定するか、またはのIncludeメソッドを使用して一括読み込みを使用しますObjectQuery<T>。

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)

指定した LINQ クエリと指定したマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。

public:
generic <typename TEntity>
 void LoadProperty(TEntity entity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ selector, System::Data::Objects::MergeOption mergeOption);

public void LoadProperty<TEntity> (TEntity entity, System.Linq.Expressions.Expression<Func<TEntity,object>> selector, System.Data.Objects.MergeOption mergeOption);

member this.LoadProperty : 'Entity * System.Linq.Expressions.Expression<Func<'Entity, obj>> * System.Data.Objects.MergeOption -> unit

Public Sub LoadProperty(Of TEntity) (entity As TEntity, selector As Expression(Of Func(Of TEntity, Object)), mergeOption As MergeOption)

型パラメーター

TEntity

指定するオブジェクトの型。

パラメーター

entity

TEntity

関連オブジェクトを読み込むソース オブジェクト。

selector

Expression<Func<TEntity,Object>>

読み込む関連オブジェクトを定義する LINQ 式。

mergeOption

MergeOption

関連オブジェクトの読み込み時に使用する MergeOption 値。

例外

ArgumentException

selector は有効な入力パラメーターを指定しません。

ArgumentNullException

selector が null です。

InvalidOperationException

entity が Detached、 Added または Deleted 状態にある場合。

- または -

entity が ObjectContext の他のインスタンスにアタッチされていない場合。

注釈

LoadProperty POCO カスタム データ クラスを使用しているときに明示的な読み込みを実現するには、 メソッドを呼び出す必要があります。

を呼び出 LoadPropertyした後、ソース エンティティのナビゲーション プロパティを介して関連オブジェクトにアクセスできます。

読み込むプロパティは LINQ 式で指定されます。これは、PropertyName が読み込まれる関連オブジェクトを返すナビゲーション プロパティと同様(entity) => entity.PropertyNameに、単純なプロパティ メンバー アクセスの形式である必要があります。 LINQ 式の他の形式が使用されている場合は、例外が発生します。

POCO カスタム データ クラスを使用する場合、Entity Data Model ツールによって生成されるエンティティ型のインスタンスのように、関連オブジェクトを明示的に読み込むことはできません。 これは、 で が呼び出されたときにLoad、 または EntityReference<TEntity> 関連オブジェクトを返すEntityCollection<TEntity>ナビゲーション プロパティがツールによってRelatedEnd生成されるためです。 遅延読み込みを使用して POCO エンティティを読み込むには、 LazyLoadingEnabledObjectContext.ContextOptionsプロパティにtrueよって返されるObjectContextOptionsのインスタンスでプロパティをに設定するか、またはのIncludeメソッドを使用して一括読み込みを使用しますObjectQuery<T>。

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)

指定した LINQ クエリと既定のマージ オプションを使用して、指定したオブジェクトに関連するオブジェクトを明示的に読み込みます。

public:
generic <typename TEntity>
 void LoadProperty(TEntity entity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ selector);

public void LoadProperty<TEntity> (TEntity entity, System.Linq.Expressions.Expression<Func<TEntity,object>> selector);

member this.LoadProperty : 'Entity * System.Linq.Expressions.Expression<Func<'Entity, obj>> -> unit

Public Sub LoadProperty(Of TEntity) (entity As TEntity, selector As Expression(Of Func(Of TEntity, Object)))

型パラメーター

TEntity

指定するオブジェクトの型。

パラメーター

entity

TEntity

関連オブジェクトを読み込むソース オブジェクト。

selector

Expression<Func<TEntity,Object>>

読み込む関連オブジェクトを定義する LINQ 式。

例外

ArgumentException

selector は有効な入力パラメーターを指定しません。

ArgumentNullException

selector が null です。

InvalidOperationException

entity が Detached、 Added または Deleted 状態にある場合。

- または -

entity が ObjectContext の他のインスタンスにアタッチされていない場合。

注釈

LoadProperty POCO カスタム データ クラスを使用しているときに明示的な読み込みを実現するには、 メソッドを呼び出す必要があります。

を呼び出 LoadPropertyした後、ソース エンティティのナビゲーション プロパティを介して関連オブジェクトにアクセスできます。

読み込むプロパティは LINQ 式で指定されます。これは、 のように (entity) => entity.PropertyName単純なプロパティ メンバー アクセスの形式である必要があります。ここで、 PropertyName は、読み込まれる関連オブジェクトを返すナビゲーション プロパティです。 LINQ 式の他の形式が使用されている場合は、例外が発生します。

POCO カスタム データ クラスを使用する場合、Entity Data Model ツールによって生成されるエンティティ型のインスタンスのように、関連オブジェクトを明示的に読み込むことはできません。 これは、 で が呼び出されたときにLoad、 または EntityReference<TEntity> 関連オブジェクトを返すEntityCollection<TEntity>ナビゲーション プロパティがツールによってRelatedEnd生成されるためです。 遅延読み込みを使用して POCO エンティティを読み込むには、 LazyLoadingEnabledObjectContext.ContextOptionsプロパティにtrueよって返されるObjectContextOptionsのインスタンスでプロパティをに設定するか、またはのIncludeメソッドを使用して一括読み込みを使用しますObjectQuery<T>。