EntityDataSource.Include Tulajdonság

Definíció

Névtér:

System.Web.UI.WebControls

Szerelvény:

System.Web.Entity.dll

Lekéri vagy beállítja azt a kifejezést, amely megadja a lekérdezési eredményekbe felvenni kívánt kapcsolódó objektumokat.

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

Tulajdonság értéke

String

A lekérdezési eredményekben visszaadandó lekérdezési útvonalak vesszővel tagolt listája.

Példák

Az alábbi XML-korrektúra egy lekérdezési útvonalat határoz meg, amely a visszaadott objektumhoz kapcsolódó objektumokat adja vissza SalesOrderHeaderContact . Mindegyiknél SalesOrderHeadera kapcsolódó SalesOrderDetail és Address az objektumok is vissza lesznek adva.

<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>

Az előző XML-példa ugyanaz, mint a következő ObjectQuery<T> nevű customers:

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

Megjegyzések

A Include vezérlő tulajdonsága EntityDataSource a lekérdezési útvonalak vesszővel tagolt listáját adja meg, amely meghatározza a visszaadott objektumokat a konkrétan lekérdezett objektummal együtt. A sztring minden egyes vesszővel tagolt értéke módosítás nélkül, az Entity Framework által végrehajtott metódus Include külön hívásaként ObjectQuery<T> lesz átadva. Ez a lekérdezés a vezérlő által EntityDataSource szabályozott adatok forrása. A Include tulajdonság a végrehajtás előtti argumentum ObjectQuery<T> .

A tulajdonsághoz Include megadott sztring ugyanazt a formátumot használja, mint a metódusnak IncludeObjectQuery<T>átadott sztring. Ha például lekérdezési útvonalakat szeretne használni a kapcsolódó objektumok automatikus betöltéséhez, olvassa el a Hogyan: Lekérdezési útvonalak használata az alakzateredményekhez című témakört.

Ha a tulajdonság lekérdezési Include útvonalak megadására szolgál, a kapcsolódó entitások tulajdonságai csak írásvédett adatkötésre használhatók. Ha a kapcsolódó objektumok nem szerepelnek explicit módon a lekérdezési útvonalban, a tulajdonságleírók továbbra is elérhetők az adatkötéshez, de maguk a tulajdonságok null értékeket adnak vissza. Ebben az esetben a kapcsolódó objektumokat explicit módon kell betölteni az értékek megjelenítéséhez. További információ: Kapcsolódó objektumok betöltése.