EntityDataSource.Include Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Entity.dll

Získá nebo nastaví výraz, který určuje související objekty, které mají být zahrnuty do výsledků dotazu.

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

Hodnota vlastnosti

String

Čárkami oddělený seznam cest dotazu, které se mají vrátit ve výsledcích dotazu.

Příklady

Následující kód XML definuje cestu dotazu, která vrací SalesOrderHeader objekty související s vráceným Contact objektem. S každou SalesOrderHeader, související SalesOrderDetail a Address objekty jsou také vráceny.

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

Předchozí příklad XML je stejný jako následující ObjectQuery<T> název customers:

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

Poznámky

Vlastnost IncludeEntityDataSource ovládacího prvku určuje čárkami oddělený seznam cest dotazu, které definují objekty, které jsou vráceny společně s konkrétně dotazovaným objektem. Každá hodnota oddělená čárkami v řetězci je předána beze změny jako samostatné volání Include metody ObjectQuery<T> , která je spuštěna Entity Framework. Tento dotaz je zdrojem dat regulovaných ovládacím EntityDataSource prvek. Vlastnost Include je argument použitý na ObjectQuery<T> před spuštěním.

Řetězec zadaný do Include vlastnosti používá stejný formát jako řetězec, který je předán Include metodě ObjectQuery<T>. Příklady použití cest dotazů k automatickému načtení souvisejících objektů najdete v tématu Postupy: Použití cest dotazů k výsledkům obrazce.

Pokud se Include vlastnost používá k určení cest dotazu, vlastnosti souvisejících entit lze použít pouze pro datovou vazbu jen pro čtení. Pokud související objekty nejsou explicitně zahrnuty do cesty dotazu, popisovače vlastností jsou stále k dispozici pro datové vazby, ale samotné vlastnosti vracejí hodnoty null. V tomto případě musí být související objekty explicitně načteny, aby se zobrazily jejich hodnoty. Další informace naleznete v tématu Načítání souvisejících objektů.