Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo ObjectQuery<T>.Include (String)

 

Data di pubblicazione: ottobre 2016

Specifica gli oggetti correlati da includere nei risultati della query.

Spazio dei nomi:   System.Data.Objects
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public ObjectQuery<T> Include(
	string path
)

Parametri

path
Type: System.String

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

Valore restituito

Type: System.Data.Objects.ObjectQuery<T>

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

Exception Condition
ArgumentNullException

path è null.

ArgumentException

path è empty.

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

I percorsi sono inclusivi. Ad esempio, se una chiamata di inclusione indica Include("Orders.OrderLines"), non solo verrà OrderLines essere inclusi, ma anche Orders. Per ulteriori informazioni, vedere il caricamento di oggetti correlati.

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

Poiché il metodo Include restituisce l'oggetto query, è possibile chiamare questo metodo più volte su un oggetto 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");

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

.NET Framework
Disponibile da 3.5
Torna all'inizio
Mostra: