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 自定義資料類別時，無法明確載入相關物件，例如實體數據模型工具所產生的實體類型實例。 這是因為工具會在上RelatedEnd呼叫 時Load產生傳回EntityCollection<TEntity>或EntityReference<TEntity>相關對象的導覽屬性。 您仍然可以使用消極式載入來載入 POCO 實體, 方法LazyLoadingEnabled是在trueObjectContext.ContextOptions屬性所傳回的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 自定義資料類別時，無法明確載入相關物件，例如實體數據模型工具所產生的實體類型實例。 這是因為工具會在上RelatedEnd呼叫 時Load產生傳回EntityCollection<TEntity>或EntityReference<TEntity>相關對象的導覽屬性。 您仍然可以使用消極式載入來載入 POCO 實體, 方法LazyLoadingEnabled是在trueObjectContext.ContextOptions屬性所傳回的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 自定義資料類別時，無法明確載入相關物件，例如實體數據模型工具所產生的實體類型實例。 這是因為工具會在上RelatedEnd呼叫 時Load產生傳回EntityCollection<TEntity>或EntityReference<TEntity>相關對象的導覽屬性。 您仍然可以使用消極式載入來載入 POCO 實體, 方法LazyLoadingEnabled是在trueObjectContext.ContextOptions屬性所傳回的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 運算式所指定，其格式必須是簡單屬性成員存取，如同 (entity) => entity.PropertyNamePropertyName 是傳回要載入之相關物件的導覽屬性。 如果使用其他形式的 LINQ 運算式，就會發生例外狀況。

使用 POCO 自定義資料類別時，無法明確載入相關物件，例如實體數據模型工具所產生的實體類型實例。 這是因為工具會在上RelatedEnd呼叫 時Load產生傳回EntityCollection<TEntity>或EntityReference<TEntity>相關對象的導覽屬性。 您仍然可以使用消極式載入來載入 POCO 實體, 方法LazyLoadingEnabled是在trueObjectContext.ContextOptions屬性所傳回的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 自定義資料類別時，無法明確載入相關物件，例如實體數據模型工具所產生的實體類型實例。 這是因為工具會在上RelatedEnd呼叫 時Load產生傳回EntityCollection<TEntity>或EntityReference<TEntity>相關對象的導覽屬性。 您仍然可以使用消極式載入來載入 POCO 實體, 方法LazyLoadingEnabled是在trueObjectContext.ContextOptions屬性所傳回的ObjectContextOptions實例上, 將屬性設定為, 或透過對的Include方法使用積極式載入ObjectQuery<T>。