EntityDataSource.Include Egenskap

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

Egenskapsvärde

Kommaavgränsad lista över frågesökvägar som ska returneras i frågeresultatet.

Exempel

Följande XML-markering definierar en frågesökväg som returnerar SalesOrderHeader objekt som är relaterade till det returnerade Contact objektet. Med varje SalesOrderHeaderreturneras även relaterade SalesOrderDetail objekt och Address objekt.

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

Föregående XML-exempel är detsamma som följande ObjectQuery<T> med namnet customers:

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

Kommentarer

Kontrollens IncludeEntityDataSource egenskap anger en kommaavgränsad lista över frågesökvägar som definierar de objekt som returneras tillsammans med det specifikt efterfrågade objektet. Varje kommaavgränsat värde i strängen skickas, utan ändring, som ett separat anrop till metoden för Include ett ObjectQuery<T> som körs av Entity Framework. Den här frågan är källan till de data som regleras av EntityDataSource kontrollen. Egenskapen Include är det argument som tillämpas på ObjectQuery<T> innan den körs.

Strängen som anges i Include egenskapen använder samma format som strängen som skickas till Include metoden ObjectQuery<T>för . Exempel på hur du använder frågesökvägar för att automatiskt läsa in relaterade objekt finns i Så här använder du frågesökvägar för att forma resultat.

När egenskapen Include används för att ange frågesökvägar kan egenskaperna för de relaterade entiteterna endast användas för skrivskyddad databindning. Om relaterade objekt inte uttryckligen ingår i frågesökvägen är egenskapsbeskrivningarna fortfarande tillgängliga för databindning, men själva egenskaperna returnerar null-värden. I det här fallet måste relaterade objekt uttryckligen läsas in för att visa deras värden. För mer information, se Läsa in relaterade objekt.