EntityCollection<TEntity>.Load(MergeOption) Metoda

Definicja

Przestrzeń nazw:

System.Data.Objects.DataClasses

Zestaw:

System.Data.Entity.dll

Ładuje powiązane obiekty do kolekcji przy użyciu określonej opcji scalania.

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 scalania obiektów w tej kolekcji z obiektami, które mogły zostać zwrócone z poprzednich zapytań względem tego samego ObjectContextobiektu .

Przykłady

Ten przykład jest oparty na modelu Adventure Works Sales Model. Aby uruchomić kod w tym przykładzie, musisz już dodać model AdventureWorks Sales Model do projektu i skonfigurować projekt do korzystania z platformy Entity Framework. Aby to zrobić, wykonaj procedury opisane w temacie Instrukcje: Ręczne konfigurowanie programu Entity Framework Project i Instrukcje: Ręczne definiowanie plików modelu i mapowania.

W tym przykładzie Contact ładuje powiązane SalesOrderHeader obiekty dla jednostki.

// Specify the customer ID.
int contactID = 4332;

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    context.ContextOptions.LazyLoadingEnabled = false;

    // Get a specified customer by contact ID.
    var contact =
        (from c in context.Contacts
         where c.ContactID == contactID
         select c).First();

    // Load the orders for the customer explicitly.
    if (!contact.SalesOrderHeaders.IsLoaded)
    {
        contact.SalesOrderHeaders.Load();
    }

    foreach (SalesOrderHeader order in contact.SalesOrderHeaders)
    {
        // Load the items for the order if not already loaded.
        if (!order.SalesOrderDetails.IsLoaded)
        {
            order.SalesOrderDetails.Load();
        }

        Console.WriteLine(String.Format("PO Number: {0}",
            order.PurchaseOrderNumber));
        Console.WriteLine(String.Format("Order Date: {0}",
            order.OrderDate.ToString()));
        Console.WriteLine("Order items:");
        foreach (SalesOrderDetail item in order.SalesOrderDetails)
        {
            Console.WriteLine(String.Format("Product: {0} "
                + "Quantity: {1}", item.ProductID.ToString(),
                item.OrderQty.ToString()));
        }
    }
}

' Specify the customer ID. 
Dim contactID As Integer = 4332

Using context As New AdventureWorksEntities()
    context.ContextOptions.LazyLoadingEnabled = False

    ' Get a specified customer by contact ID. 
    Dim contact = (From c In context.Contacts
        Where c.ContactID = contactID
        Select c).First()

    ' Load the orders for the customer explicitly. 
    If Not contact.SalesOrderHeaders.IsLoaded Then
        contact.SalesOrderHeaders.Load()
    End If

    For Each order As SalesOrderHeader In contact.SalesOrderHeaders
        ' Load the items for the order if not already loaded. 
        If Not order.SalesOrderDetails.IsLoaded Then
            order.SalesOrderDetails.Load()
        End If

        Console.WriteLine(String.Format("PO Number: {0}", order.PurchaseOrderNumber))
        Console.WriteLine(String.Format("Order Date: {0}", order.OrderDate.ToString()))
        Console.WriteLine("Order items:")
        For Each item As SalesOrderDetail In order.SalesOrderDetails
            Console.WriteLine(String.Format("Product: {0} Quantity: {1}", _
                                              item.ProductID.ToString(), item.OrderQty.ToString()))
        Next
    Next
End Using

Uwagi

Ta metoda wywołuje metodę wewnętrzną RelatedEnd.ValidateLoad przed załadowaniem kolekcji, która sprawdza, czy Load wywołanie ma poprawne warunki. Metoda RelatedEnd.ValidateLoad sprawdza, czy:

• Istnieje prawidłowa ObjectContext wartość.
• Jednostka nie jest w Deleted stanie.
• MergeOption dla Load musi być NoTracking , jeśli i tylko wtedy, gdy jednostka źródłowa to NoTracking. Jeśli jednostka źródłowa została pobrana z dowolnego innego MergeOptionelementu , Load MergeOption może to być dowolny element, ale NoTracking (na przykład jednostka mogła zostać załadowana za OverwriteChanges pomocą polecenia , a Load opcja może być AppendOnly).
• Jeśli mergeOption jest NoTrackingto , Load nie jest wywoływana w już załadowanej jednostce i Load nie jest wywoływana w niepustej, nie śledzonej RelatedEnd.

Gdy obiekty w kolekcji są już ładowane do ObjectContextklasy , Load metoda wymusza MergeOption określony przez mergeOption parametr . Aby uzyskać więcej informacji, zobacz Identity Resolution, State Management i Change Tracking.

Aby jawnie załadować powiązane obiekty, należy wywołać metodę Load na powiązanym końcu zwróconym przez właściwość nawigacji. W przypadku relacji jeden do wielu wywołaj metodę w metodzie Load EntityCollection<TEntity>. W przypadku relacji jeden do jednego wywołaj metodę Load w dniu EntityReference<TEntity>. Spowoduje to załadowanie powiązanych danych obiektu do kontekstu obiektu. Możesz wyliczyć za pomocą kolekcji zwróconych wyników przy użyciu pętli (For Each...Nextw Visual Basic) i warunkowo wywołać Load metodę foreach on EntityReference<TEntity> i EntityCollection<TEntity> właściwości dla każdej jednostki w wynikach.

Metoda Load ładuje powiązane obiekty ze źródła danych, niezależnie od tego, czy IsLoaded jest to true.

Uwaga

Podczas wywoływania Load metody podczas foreach wyliczania (C#) lub For Each (Visual Basic) usługi Object Services próbują otworzyć nowy czytnik danych. Ta operacja zakończy się niepowodzeniem, chyba że włączono wiele aktywnych zestawów wyników, określając multipleactiveresultsets=true w parametrach połączenia. Możesz również załadować wynik zapytania do List<T> kolekcji. Spowoduje to zamknięcie czytnika danych i umożliwia wyliczanie kolekcji w celu załadowania odwołanych obiektów.

Metoda EntityCollection<TEntity>.Load jest synchronizowana z EntityReference<TEntity>.Load metodą .