ObjectContext.LoadProperty 方法

定義

在您使用 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

巡覽屬性的名稱,這個屬性會傳回要載入的相關物件。

例外狀況

entity 的狀態為 DetachedAddedDeleted時。

-或-

entity 會附加到 ObjectContext 的另一個執行個體。

備註

LoadProperty當您使用POCO自定義資料類別時,必須呼叫 方法來達成明確載入。

呼叫 LoadProperty之後,即可透過來源實體的導覽屬性來存取相關物件。

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

LoadProperty呼叫 方法時,物件會使用的AppendOnly預設值MergeOption載入 至 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 值。

例外狀況

entity 的狀態為 DetachedAddedDeleted時。

-或-

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 值。

例外狀況

selector 不會提供有效的輸入參數。

selector 為 null。

entity 的狀態為 DetachedAddedDeleted時。

-或-

entity 會附加到 ObjectContext 的另一個執行個體。

備註

LoadProperty當您使用POCO自定義資料類別時,必須呼叫 方法來達成明確載入。

呼叫 LoadProperty之後,即可透過來源實體的導覽屬性來存取相關物件。

要載入的屬性是由 LINQ 運算式所指定,其格式必須是簡單屬性成員存取,如同 PropertyName 是傳回要載入之相關物件的導覽屬性。(entity) => entity.PropertyName 如果使用其他類型的 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 運算式。

例外狀況

selector 不會提供有效的輸入參數。

selector 為 null。

entity 的狀態為 DetachedAddedDeleted時。

-或-

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>

適用於