EntityDataSource.Include Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Entity.dll

Mendapatkan atau mengatur ekspresi yang menentukan objek terkait untuk disertakan dalam hasil kueri.

public:
 property System::String ^ Include { System::String ^ get(); void set(System::String ^ value); };

public string Include { get; set; }

member this.Include : string with get, set

Public Property Include As String

Nilai Properti

String

Daftar jalur kueri yang dipisahkan koma untuk dikembalikan dalam hasil kueri.

Contoh

Markup XML berikut menentukan jalur kueri yang mengembalikan SalesOrderHeader objek yang terkait dengan objek yang dikembalikan Contact . Dengan masing-masing SalesOrderHeader, objek dan Address terkait SalesOrderDetail juga dikembalikan.

<asp:EntityDataSource ID="ContactDataSource" runat="server"
    AutoGenerateWhereClause="True" ConnectionString="name=AdventureWorksEntities"
    DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
    EnableInsert="True" EnableUpdate="True" EntitySetName="Contact"
    Include="SalesOrderHeader.SalesOrderDetail, SalesOrderHeader.Address">
    <WhereParameters>
        <asp:ControlParameter ControlID="customerId" Name="ContactID"
            PropertyName="Text" />
    </WhereParameters>
</asp:EntityDataSource>

Contoh XML sebelumnya sama dengan berikut ini ObjectQuery<T> bernama customers:

ObjectQuery<Contact> customers =
      context.Contact
       .Where("it.ContactID = @ContactID",
         new ObjectParameter("ContactID", customerId))
        .Include("SalesOrderHeader.SalesOrderDetail")
        .Include("SalesOrderHeader.Address");

Keterangan

Properti IncludeEntityDataSource kontrol menentukan daftar jalur kueri yang dipisahkan koma yang menentukan objek yang dikembalikan bersama dengan objek yang dikueri secara khusus. Setiap nilai yang dipisahkan koma dalam string diteruskan, tanpa modifikasi, sebagai panggilan terpisah ke Include metode ObjectQuery<T> yang dijalankan oleh Kerangka Kerja Entitas. Kueri ini adalah sumber data yang diatur oleh EntityDataSource kontrol. Properti Include adalah argumen yang diterapkan ke ObjectQuery<T> sebelum dijalankan.

String yang disediakan ke Include properti menggunakan format yang sama dengan string yang diteruskan ke Include metode ObjectQuery<T>. Untuk contoh cara menggunakan jalur kueri untuk memuat objek terkait secara otomatis, lihat Cara: Menggunakan Jalur Kueri ke Hasil Bentuk.

Include Saat properti digunakan untuk menentukan jalur kueri, properti entitas terkait hanya dapat digunakan untuk pengikatan data baca-saja. Jika objek terkait tidak secara eksplisit disertakan dalam jalur kueri, deskriptor properti masih tersedia untuk pengikatan data, tetapi properti itu sendiri mengembalikan nilai null. Dalam hal ini, objek terkait harus dimuat secara eksplisit untuk menampilkan nilainya. Untuk informasi selengkapnya, lihat Memuat Objek Terkait.