EntityReference<TEntity>.Load(MergeOption) Metoda

Definicja

Ładuje obiekt powiązany dla tego elementu EntityReference<TEntity> z określoną opcją scalania.Loads the related object for this EntityReference<TEntity> with the specified merge option.

public:
 override void Load(System::Data::Objects::MergeOption mergeOption);
public override void Load (System.Data.Objects.MergeOption mergeOption);
override this.Load : System.Data.Objects.MergeOption -> unit
Public Overrides Sub Load (mergeOption As MergeOption)

Parametry

mergeOption
MergeOption

Określa sposób, w jaki obiekt powinien być zwracany, jeśli już istnieje w ObjectContext .Specifies how the object should be returned if it already exists in the ObjectContext.

Wyjątki

Źródło EntityReference<TEntity> ma wartość null .The source of the EntityReference<TEntity> is null.

-lub--or-

Zapytanie zwróciło więcej niż jedno powiązane zakończenie.A query returned more than one related end.

-lub--or-

Zapytanie zwróciło zerowe punkty końcowe i oczekiwano jednego powiązanego końca.A query returned zero related ends, and one related end was expected.

Uwagi

Ta metoda jest używana do ładowania powiązanego obiektu.This method is used to load the related object.

Po załadowaniu obiekt pokrewny jest dostępny z Value właściwości.When loaded, the related object is accessed from the Value property.

Aby jawnie załadować powiązane obiekty, należy wywołać Load metodę na powiązanym końcu zwracanym przez właściwość nawigacji.To explicitly load related objects, you must call the Load method on the related end returned by the navigation property. W przypadku relacji jeden-do-wielu Wywołaj Load metodę on EntityCollection<TEntity> i dla relacji jeden-do-jednego Wywołaj wartość Load on EntityReference<TEntity> .For a one-to-many relationship, call the Load method on EntityCollection<TEntity>, and for a one-to-one relationship, call the Load on EntityReference<TEntity>. Spowoduje to załadowanie powiązanych danych obiektu do kontekstu obiektu.This loads the related object data into the object context. Gdy zapytanie zwraca wyniki, można wyliczyć przez kolekcję obiektów przy użyciu foreach pętli ( For Each...Next w Visual Basic) i warunkowo wywołać Load metodę dla EntityReference<TEntity> i EntityCollection<TEntity> właściwości dla każdej jednostki w wynikach.When a query returns results, you can enumerate through the collection of objects using a foreach loop (For Each...Next in Visual Basic) and conditionally call the Load method on EntityReference<TEntity> and EntityCollection<TEntity> properties for each entity in the results.

LoadMetoda ładuje powiązane obiekty ze źródła danych niezależnie od tego, czy IsLoaded jest to true .The Load method loads related objects from the data source whether or not IsLoaded is true.

Uwaga

Gdy wywoływana jest Load Metoda podczas foreach wyliczania (C#) lub For Each (Visual Basic), usługi obiektów próbują otworzyć nowy czytnik danych.When you call the Load method during a foreach (C#) or For Each (Visual Basic) enumeration, Object Services tries to open a new data reader. Ta operacja zakończy się niepowodzeniem, jeśli nie włączono wielu aktywnych zestawów wyników przez określenie multipleactiveresultsets=true w parametrach połączenia.This operation will fail unless you have enabled multiple active results sets by specifying multipleactiveresultsets=true in the connection string. Możesz również załadować wynik zapytania do List<T> kolekcji.You can also load the result of the query into a List<T> collection. Spowoduje to zamknięcie czytnika danych i umożliwienie wyliczenia kolekcji w celu załadowania obiektów, do których istnieją odwołania.This closes the data reader and enables you to enumerate over the collection to load referenced objects.

Ta metoda wywołuje wewnętrzną RelatedEnd.ValidateLoad metodę przed załadowaniem powiązanego obiektu, który sprawdza, czy wywołanie Load ma poprawne warunki.This method calls the internal RelatedEnd.ValidateLoad method before loading the related object, which validates that a call to Load has the correct conditions. RelatedEnd.ValidateLoadMetoda sprawdza, czy:The RelatedEnd.ValidateLoad method checks that:

Gdy obiekt pokrewny jest już załadowany w ObjectContext , Load Metoda wymusza MergeOption określony przez mergeOption parametr.When the related object is already loaded in the ObjectContext, the Load method enforces the MergeOption specified by the mergeOption parameter. Aby uzyskać więcej informacji, zobacz rozpoznawanie tożsamości, zarządzanie stanami i Change Tracking.For more information, see Identity Resolution, State Management, and Change Tracking.

Dotyczy