EntityDataSource.Include Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Entity.dll

Pobiera lub ustawia wyrażenie, które określa powiązane obiekty 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

Rozdzielona przecinkami lista ścieżek zapytania, które mają być zwracane w wynikach zapytania.

Przykłady

Poniższy znacznik XML definiuje ścieżkę zapytania, która zwraca SalesOrderHeader obiekty powiązane z zwracanym Contact obiektem. Przy każdym SalesOrderHeaderobiekcie są również zwracane powiązane SalesOrderDetail obiekty i Address .

<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 XML jest taki sam jak w przypadku następującej ObjectQuery<T> nazwy customers:

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

Uwagi

Właściwość IncludeEntityDataSource kontrolki określa rozdzielaną przecinkami listę ścieżek zapytania, które definiują obiekty zwracane razem z obiektem specjalnie zapytanym. Każda wartość rozdzielona przecinkami w ciągu jest przekazywana bez modyfikacji jako oddzielne wywołanie Include metody wykonywanej ObjectQuery<T> przez platformę Entity Framework. To zapytanie jest źródłem danych regulowanych przez kontrolkę EntityDataSource . Właściwość Include jest argumentem zastosowanym ObjectQuery<T> do elementu przed jego wykonaniem.

Ciąg dostarczony do Include właściwości używa tego samego formatu co ciąg przekazywany do Include metody ObjectQuery<T>. Aby zapoznać się z przykładami używania ścieżek zapytań do automatycznego ładowania powiązanych obiektów, zobacz Instrukcje: używanie ścieżek zapytania do wyników kształtu.

Include Gdy właściwość jest używana do określania ścieżek zapytania, właściwości powiązanych jednostek mogą być używane tylko do wią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 powiązane obiekty muszą być jawnie załadowane, aby wyświetlić ich wartości. Aby uzyskać więcej informacji, zobacz Ładowanie powiązanych obiektów.