ObjectQuery<T>.Include(String) Metódus

Definíció

Névtér:
System.Data.Objects
Szerelvény:
System.Data.Entity.dll

Megadja a lekérdezés eredményében felvenni kívánt kapcsolódó objektumokat.

public:
 System::Data::Objects::ObjectQuery<T> ^ Include(System::String ^ path);
public System.Data.Objects.ObjectQuery<T> Include(string path);
member this.Include : string -> System.Data.Objects.ObjectQuery<'T>
Public Function Include (path As String) As ObjectQuery(Of T)

Paraméterek

path
String

A lekérdezési eredményekben visszaadandó kapcsolódó objektumok ponttal tagolt listája.

Válaszok

ObjectQuery<T>

A megadott lekérdezési útvonallal rendelkező új ObjectQuery<T> .

Kivételek

ArgumentNullException

path az null.

ArgumentException

path az empty.

Példák

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    // Define an object query with a path that returns
    // orders and items for a specific contact.
    Contact contact =
        context.Contacts.Include("SalesOrderHeaders.SalesOrderDetails")
        .FirstOrDefault();

    // Execute the query and display information for each item
    // in the orders that belong to the first contact.
    foreach (SalesOrderHeader order in contact
        .SalesOrderHeaders)
    {
        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()));
        }
    }
}

Megjegyzések

A lekérdezési útvonalak entitás SQL- és LINQ-lekérdezésekkel is használhatók.

Az útvonalak mindenre kiterjednek. Ha például egy belefoglalási Include("Orders.OrderLines")hívás azt jelzi, hogy nem csak OrderLines a rendszer tartalmazza a hívást, hanem azt is Orders. További információ: Kapcsolódó objektumok betöltése.

Amikor meghívja a metódust Include , a lekérdezési útvonal csak a visszaadott példányon ObjectQuery<T>érvényes. A többi példányt ObjectQuery<T> és magát az objektumkörnyezetet nem érinti.

Mivel a Include metódus visszaadja a lekérdezési objektumot, ezt a metódust többször is meghívhatja egy ObjectQuery<T> lekérdezés több elérési útjának megadásához, ahogyan az alábbi példában is látható:

// Create a SalesOrderHeader query with two query paths,
// one that returns order items and a second that returns the
// billing and shipping addresses for each order.
ObjectQuery<SalesOrderHeader> query =
    context.SalesOrderHeaders.Include("SalesOrderDetails").Include("Address");

A következőre érvényes:

Lásd még