ObjectQuery<T>.Include(String) Metodo

Definizione

Spazio dei nomi:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Specifica gli oggetti correlati da includere nei risultati della query.

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)

Parametri

path
String

Elenco delimitato da punti di oggetti correlati da restituire nei risultati della query.

Valori restituiti

ObjectQuery<T>

ObjectQuery<T> Nuovo oggetto con il percorso di query definito.

Eccezioni

ArgumentNullException

path è null.

ArgumentException

path è empty.

Esempio

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()));
        }
    }
}

Commenti

I percorsi di query possono essere usati con query Entity SQL e LINQ.

I percorsi sono tutti inclusivi. Ad esempio, se una chiamata di inclusione indica Include("Orders.OrderLines"), non solo verrà OrderLines incluso, ma anche Orders. Per altre informazioni, vedere Caricamento di oggetti correlati.

Quando si chiama il Include metodo , il percorso della query è valido solo nell'istanza restituita di ObjectQuery<T>. Le altre istanze di e il contesto dell'oggetto ObjectQuery<T> stesso non sono interessate.

Poiché il Include metodo restituisce l'oggetto query, è possibile chiamare questo metodo più volte su un ObjectQuery<T> per specificare più percorsi per la query, come nell'esempio seguente:

// 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");

Si applica a

Vedi anche