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 przy użyciu 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 korzystania z 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 jednostek. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty pokrewne lub EntityReference<TEntity> , gdy Load jest wywoływana w obiekcie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając LazyLoadingEnabled właściwość na true wartość w wystąpieniu ObjectContextOptions , które jest zwracane przez ObjectContext.ContextOptions właściwość, lub przy użyciu chętnego ładowania z Include metodą w ObjectQuery<T>obiekcie .

LoadProperty(Object, String)

Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i przy użyciu 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

Wartość entity jest w Detachedstanie , Added lub Deleted

-lub-

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

Uwagi

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

Po wywołaniu LoadPropertymetody dostęp do powiązanego obiektu można uzyskać za pośrednictwem właściwości nawigacji jednostki źródłowej.

W przypadku korzystania z 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 jednostek. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty pokrewne lub EntityReference<TEntity> , gdy Load jest wywoływana w obiekcie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając LazyLoadingEnabled właściwość na true wartość w wystąpieniu ObjectContextOptions , które jest zwracane przez ObjectContext.ContextOptions właściwość, lub przy użyciu chętnego ładowania z Include metodą w ObjectQuery<T>obiekcie .

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

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

Wartość entity jest w Detachedstanie , Added lub Deleted

-lub-

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

Uwagi

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

Po wywołaniu LoadPropertymetody dostęp do powiązanego obiektu można uzyskać za pośrednictwem właściwości nawigacji jednostki źródłowej.

W przypadku korzystania z 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 jednostek. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty pokrewne lub EntityReference<TEntity> , gdy Load jest wywoływana w obiekcie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając LazyLoadingEnabled właściwość na true wartość w wystąpieniu ObjectContextOptions , które jest zwracane przez ObjectContext.ContextOptions właściwość, lub przy użyciu chętnego ładowania z Include metodą w ObjectQuery<T>obiekcie .

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 obiekty pokrewne do załadowania.

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

Wartość entity jest w Detachedstanie , Added lub Deleted

-lub-

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

Uwagi

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

Po wywołaniu LoadPropertymetody dostęp do powiązanego obiektu można uzyskać 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 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 są używane inne formy wyrażenia LINQ.

W przypadku korzystania z 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 jednostek. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty pokrewne lub EntityReference<TEntity> , gdy Load jest wywoływana w obiekcie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając LazyLoadingEnabled właściwość na true wartość w wystąpieniu ObjectContextOptions , które jest zwracane przez ObjectContext.ContextOptions właściwość, lub przy użyciu chętnego ładowania z Include metodą w ObjectQuery<T>obiekcie .

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 obiekty pokrewne do załadowania.

Wyjątki

ArgumentException

selector nie dostarcza prawidłowego parametru wejściowego.

ArgumentNullException

selector ma wartość null.

InvalidOperationException

Wartość entity jest w Detachedstanie , Added lub Deleted

-lub-

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

Uwagi

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

Po wywołaniu LoadPropertymetody dostęp do powiązanego obiektu można uzyskać 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.PropertyNameprzypadku , gdzie PropertyName jest właściwością nawigacji, która zwraca powiązane obiekty do załadowania. Wyjątek wystąpi, jeśli są używane inne formy wyrażenia LINQ.

W przypadku korzystania z 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 jednostek. Jest to spowodowane tym, że narzędzia generują właściwości nawigacji, które zwracają EntityCollection<TEntity> obiekty pokrewne lub EntityReference<TEntity> , gdy Load jest wywoływana w obiekcie RelatedEnd. Jednostki POCO można nadal ładować przy użyciu ładowania z opóźnieniem, ustawiając LazyLoadingEnabled właściwość na true wartość w wystąpieniu ObjectContextOptions , które jest zwracane przez ObjectContext.ContextOptions właściwość, lub przy użyciu chętnego ładowania z Include metodą w ObjectQuery<T>obiekcie .