ObjectQuery<T>.Include(String) Yöntem

Tanım

Ad Alanı:

System.Data.Objects

Bütünleştirilmiş Kod:

System.Data.Entity.dll

Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.

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)

Parametreler

path

String

Sorgu sonuçlarında döndürülecek ilişkili nesnelerin noktalı olarak ayrılmış listesi.

Döndürülenler

ObjectQuery<T>

Tanımlı sorgu yolunu içeren yeni ObjectQuery<T> bir.

Özel durumlar

ArgumentNullException

path, null değeridir.

ArgumentException

path, empty değeridir.

Örnekler

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

Açıklamalar

Sorgu yolları, Entity SQL ve LINQ sorgularıyla kullanılabilir.

Yollar her şey dahil. Örneğin, bir include çağrısı gösteriyorsa Include("Orders.OrderLines"), yalnızca OrderLines dahil değil, aynı zamanda Ordersda eklenir. Daha fazla bilgi için bkz . İlgili Nesneleri Yükleme.

yöntemini çağırdığınızda Include sorgu yolu yalnızca döndürülen örneğinde ObjectQuery<T>geçerlidir. ve nesne bağlamının diğer örnekleri ObjectQuery<T> etkilenmez.

Include yöntemi sorgu nesnesini döndürdüğünden, aşağıdaki örnekte olduğu gibi sorgu için birden çok yol belirtmek üzere bu yöntemi üzerinde ObjectQuery<T> birden çok kez çağırabilirsiniz:

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

Ayrıca bkz.

• Verileri Nesne Olarak Sorgulama (Entity Framework)