ObjectContext.LoadProperty Metoda

Definicja

Przestrzeń nazw:

System.Data.Objects

Zestaw:

System.Data.Entity.dll

Jawnie ładuje powiązany obiekt, gdy używasz niestandardowych klas danych POCO.

Przeciążenia

LoadProperty(Object, String)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i użyj domyślnej opcji scalania.
LoadProperty(Object, String, MergeOption)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i przy użyciu określonej opcji scalania.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określone zapytanie LINQ i przy użyciu określonej opcji scalania.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określone zapytanie LINQ i przy użyciu domyślnej opcji scalania.

Uwagi

W przypadku używania niestandardowych klas danych POCO nie można jawnie załadować powiązanych obiektów, takich jak wystąpienia typów jednostek generowanych przez narzędzia modelu danych jednostki. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty powiązane lub EntityReference<TEntity> , gdy Load są wywoływane w elemecie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając właściwość na true wystąpienie, ObjectContextOptions które jest zwracane przez ObjectContext.ContextOptions właściwość, lub za pomocą chętnego ładowania Include z metodą na ObjectQuery<T>.LazyLoadingEnabled

LoadProperty(Object, String)

Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i użyj domyślnej opcji scalania.

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)

Parametry

entity

Object

Jednostka, dla której mają zostać załadowane powiązane obiekty.

navigationProperty

String

Nazwa właściwości nawigacji, która zwraca obiekty pokrewne do załadowania.

Wyjątki

InvalidOperationException

Jest entity w Detachedstanie , Added lub Deleted ,

-lub-

Element entity jest dołączony do innego wystąpienia klasy ObjectContext.

Uwagi

Metoda musi być wywoływana LoadProperty w celu osiągnięcia jawnego ładowania w przypadku używania niestandardowych klas danych POCO.

Po wywołaniu wywołania LoadPropertyobiekt pokrewny można uzyskać dostęp za pośrednictwem właściwości nawigacji jednostki źródłowej.

W przypadku używania niestandardowych klas danych POCO nie można jawnie załadować powiązanych obiektów, takich jak wystąpienia typów jednostek generowanych przez narzędzia modelu danych jednostki. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty powiązane lub EntityReference<TEntity> , gdy Load są wywoływane w elemecie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając właściwość na true wystąpienie, ObjectContextOptions które jest zwracane przez ObjectContext.ContextOptions właściwość, lub za pomocą chętnego ładowania Include z metodą na ObjectQuery<T>.LazyLoadingEnabled

Po wywołaniu LoadProperty metody obiekty są ładowane do ObjectContext obiektu przy użyciu wartości domyślnej MergeOption .AppendOnly

LoadProperty(Object, String, MergeOption)

Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i przy użyciu określonej opcji scalania.

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)

Parametry

entity

Object

Jednostka, dla której mają zostać załadowane powiązane obiekty.

navigationProperty

String

Nazwa właściwości nawigacji, która zwraca obiekty pokrewne do załadowania.

mergeOption

MergeOption

Wartość MergeOption do użycia podczas ładowania powiązanych obiektów.

Wyjątki

InvalidOperationException

Jest entity w Detachedstanie , Added lub Deleted ,

-lub-

Element entity jest dołączony do innego wystąpienia klasy ObjectContext.

Uwagi

Metoda musi być wywoływana LoadProperty w celu osiągnięcia jawnego ładowania w przypadku używania niestandardowych klas danych POCO.

Po wywołaniu wywołania LoadPropertyobiekt pokrewny można uzyskać dostęp za pośrednictwem właściwości nawigacji jednostki źródłowej.

W przypadku używania niestandardowych klas danych POCO nie można jawnie załadować powiązanych obiektów, takich jak wystąpienia typów jednostek generowanych przez narzędzia modelu danych jednostki. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty powiązane lub EntityReference<TEntity> , gdy Load są wywoływane w elemecie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając właściwość na true wystąpienie, ObjectContextOptions które jest zwracane przez ObjectContext.ContextOptions właściwość, lub za pomocą chętnego ładowania Include z metodą na ObjectQuery<T>.LazyLoadingEnabled

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

Jawnie ładuje obiekt powiązany z podanym obiektem przez określone zapytanie LINQ i przy użyciu określonej opcji scalania.

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)

Parametry typu

TEntity

Typ dostarczonego obiektu.

Parametry

entity

TEntity

Obiekt źródłowy, dla którego mają zostać załadowane powiązane obiekty.

selector

Expression<Func<TEntity,Object>>

Wyrażenie LINQ definiujące załadowane powiązane obiekty.

mergeOption

MergeOption

Wartość MergeOption do użycia podczas ładowania powiązanych obiektów.

Wyjątki

ArgumentException

selector nie dostarcza prawidłowego parametru wejściowego.

ArgumentNullException

selector ma wartość null.

InvalidOperationException

Jest entity w Detachedstanie , Added lub Deleted ,

-lub-

Element entity jest dołączony do innego wystąpienia klasy ObjectContext.

Uwagi

Metoda musi być wywoływana LoadProperty w celu osiągnięcia jawnego ładowania w przypadku używania niestandardowych klas danych POCO.

Po wywołaniu wywołania LoadPropertyobiekt pokrewny można uzyskać dostęp za pośrednictwem właściwości nawigacji jednostki źródłowej.

Właściwość do załadowania jest określana przez wyrażenie LINQ, które musi być w postaci prostego dostępu do elementu członkowskiego właściwości, tak jak w przypadku, gdy (entity) => entity.PropertyNamePropertyName jest właściwością nawigacji, która zwraca powiązane obiekty do załadowania. Wyjątek wystąpi, jeśli zostaną użyte inne formy wyrażenia LINQ.

W przypadku używania niestandardowych klas danych POCO nie można jawnie załadować powiązanych obiektów, takich jak wystąpienia typów jednostek generowanych przez narzędzia modelu danych jednostki. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty powiązane lub EntityReference<TEntity> , gdy Load są wywoływane w elemecie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając właściwość na true wystąpienie, ObjectContextOptions które jest zwracane przez ObjectContext.ContextOptions właściwość, lub za pomocą chętnego ładowania Include z metodą na ObjectQuery<T>.LazyLoadingEnabled

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

Jawnie ładuje obiekt powiązany z podanym obiektem przez określone zapytanie LINQ i przy użyciu domyślnej opcji scalania.

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)))

Parametry typu

TEntity

Typ dostarczonego obiektu.

Parametry

entity

TEntity

Obiekt źródłowy, dla którego mają zostać załadowane powiązane obiekty.

selector

Expression<Func<TEntity,Object>>

Wyrażenie LINQ definiujące załadowane powiązane obiekty.

Wyjątki

ArgumentException

selector nie dostarcza prawidłowego parametru wejściowego.

ArgumentNullException

selector ma wartość null.

InvalidOperationException

Jest entity w Detachedstanie , Added lub Deleted ,

-lub-

Element entity jest dołączony do innego wystąpienia klasy ObjectContext.

Uwagi

Metoda musi być wywoływana LoadProperty w celu osiągnięcia jawnego ładowania w przypadku używania niestandardowych klas danych POCO.

Po wywołaniu wywołania LoadPropertyobiekt pokrewny można uzyskać dostęp za pośrednictwem właściwości nawigacji jednostki źródłowej.

Właściwość do załadowania jest określana przez wyrażenie LINQ, które musi być w postaci prostego dostępu do elementu członkowskiego właściwości, jak w , (entity) => entity.PropertyNamegdzie PropertyName jest właściwością nawigacji, która zwraca powiązane obiekty do załadowania. Wyjątek wystąpi, jeśli zostaną użyte inne formy wyrażenia LINQ.

W przypadku używania niestandardowych klas danych POCO nie można jawnie załadować powiązanych obiektów, takich jak wystąpienia typów jednostek generowanych przez narzędzia modelu danych jednostki. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty powiązane lub EntityReference<TEntity> , gdy Load są wywoływane w elemecie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając właściwość na true wystąpienie, ObjectContextOptions które jest zwracane przez ObjectContext.ContextOptions właściwość, lub za pomocą chętnego ładowania Include z metodą na ObjectQuery<T>.LazyLoadingEnabled