ObjectQuery<T>.Include(String) Metode

Referensi

Definisi

Ruang nama:: System.Data.Objects

Rakitan:: System.Data.Entity.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan objek terkait untuk disertakan dalam hasil kueri.

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)

Parameter

path: String

Daftar objek terkait yang dipisahkan titik untuk dikembalikan dalam hasil kueri.

Mengembalikan

ObjectQuery<T>

ObjectQuery<T> Baru dengan jalur kueri yang ditentukan.

Pengecualian

ArgumentNullException

pathadalah null.

ArgumentException

pathadalah empty.

Contoh

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

Keterangan

Jalur kueri dapat digunakan dengan kueri SQL Entitas dan LINQ.

Jalur bersifat all-inclusive. Misalnya, jika panggilan sertakan menunjukkan Include("Orders.OrderLines"), tidak hanya akan OrderLines disertakan, tetapi juga Orders. Untuk informasi selengkapnya, lihat Memuat Objek Terkait.

Saat Anda memanggil Include metode , jalur kueri hanya valid pada instans yang ObjectQuery<T>dikembalikan dari . Instans lain dari ObjectQuery<T> dan konteks objek itu sendiri tidak terpengaruh.

Include Karena metode mengembalikan objek kueri, Anda bisa memanggil metode ini beberapa kali pada ObjectQuery<T> untuk menentukan beberapa jalur untuk kueri, seperti dalam contoh berikut:

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

Berlaku untuk

Lihat juga

Mengkueri Data sebagai Objek (Kerangka Kerja Entitas)

Bagikan melalui