EntityDataSource.Include Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Entity.dll

Pobiera lub ustawia wyrażenie określające obiekty powiązane do uwzględnienia w wynikach zapytania.

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

Wartość właściwości

String

Rozdzielana przecinkami lista ścieżek zapytania, które mają zostać zwrócone w wynikach zapytania.

Przykłady

Poniższy znacznik XML definiuje ścieżkę zapytania, która zwraca SalesOrderHeader obiekty powiązane z zwróconym Contact obiektem. Za każdym razem SalesOrderHeader SalesOrderDetail Address są zwracane powiązane i obiekty.

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

Poprzedni przykład kodu XML jest taki sam jak ObjectQuery<T> nazwa customers :

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

Uwagi

IncludeWłaściwość EntityDataSource kontrolki określa rozdzieloną przecinkami listę ścieżek zapytania, które definiują obiekty, które są zwracane razem z zapytaniem zapytania. Każda wartość oddzielona przecinkami w ciągu jest przenoszona, bez modyfikacji, jako oddzielne wywołanie Include metody ObjectQuery<T> , która jest wykonywana przez Entity Framework. To zapytanie jest źródłem danych regulowanych przez EntityDataSource formant. IncludeWłaściwość jest argumentem zastosowanym do ObjectQuery<T> przed wykonaniem.

Ciąg dostarczony do Include właściwości używa tego samego formatu co ciąg, który jest przekazywany do Include metody ObjectQuery<T> . Przykłady użycia ścieżek zapytania do automatycznego ładowania obiektów pokrewnych można znaleźć w temacie How to: use Query Paths to Shape Results.

Gdy Include Właściwość jest używana do określania ścieżek zapytania, właściwości powiązanych jednostek mogą być używane tylko dla powiązania danych tylko do odczytu. Jeśli powiązane obiekty nie są jawnie uwzględnione w ścieżce zapytania, deskryptory właściwości są nadal dostępne dla powiązania danych, ale same właściwości zwracają wartości null. W takim przypadku obiekty powiązane muszą być jawnie załadowane w celu wyświetlenia ich wartości. Aby uzyskać więcej informacji, zobacz ładowanie powiązanych obiektów.