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 实体，方法是在 属性返回的 实例ObjectContextOptions上将 属性设置为 LazyLoadingEnabled ，或通过对 上的 ObjectQuery<T>方法使用预先加载来Include加载。ObjectContext.ContextOptionstrue

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 实体，方法是在 属性返回的 实例ObjectContextOptions上将 属性设置为 LazyLoadingEnabled ，或通过对 上的 ObjectQuery<T>方法使用预先加载来Include加载。ObjectContext.ContextOptionstrue

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 实体，方法是在 属性返回的 实例ObjectContextOptions上将 属性设置为 LazyLoadingEnabled ，或通过对 上的 ObjectQuery<T>方法使用预先加载来Include加载。ObjectContext.ContextOptionstrue

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 实体，方法是在 属性返回的 实例ObjectContextOptions上将 属性设置为 LazyLoadingEnabled ，或通过对 上的 ObjectQuery<T>方法使用预先加载来Include加载。ObjectContext.ContextOptionstrue

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 实体，方法是在 属性返回的 实例ObjectContextOptions上将 属性设置为 LazyLoadingEnabled ，或通过对 上的 ObjectQuery<T>方法使用预先加载来Include加载。ObjectContext.ContextOptionstrue