EntityDataSource.Include Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ottiene o imposta l'espressione che specifica gli oggetti correlati da includere nei risultati della query.

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

Valore della proprietà

String

Elenco di percorsi di query separato da virgole da restituire nei risultati della query.

Esempio

Il markup XML seguente definisce un percorso di query che restituisce SalesOrderHeader oggetti correlati all'oggetto restituito Contact . Con ogni SalesOrderHeader, vengono restituiti anche gli oggetti e Address correlatiSalesOrderDetail.

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

L'esempio XML precedente è identico al seguente ObjectQuery<T> denominato customers:

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

Commenti

La Include proprietà del EntityDataSource controllo specifica un elenco delimitato da virgole di percorsi di query che definiscono gli oggetti restituiti insieme all'oggetto sottoposto a query specifico. Ogni valore delimitato da virgole nella stringa viene passato, senza modifiche, come chiamata separata al Include metodo di un ObjectQuery<T> oggetto eseguito da Entity Framework. Questa query è l'origine dei dati regolamentati dal EntityDataSource controllo . La Include proprietà è l'argomento applicato all'oggetto prima dell'esecuzione ObjectQuery<T> .

La stringa fornita alla Include proprietà utilizza lo stesso formato della stringa passata al Include metodo di ObjectQuery<T>. Per esempi di come usare i percorsi di query per caricare automaticamente gli oggetti correlati, vedere Procedura: Usare i percorsi di query per modellare i risultati.

Quando la Include proprietà viene usata per specificare i percorsi di query, le proprietà delle entità correlate possono essere usate solo per l'associazione dati di sola lettura. Se gli oggetti correlati non sono inclusi in modo esplicito nel percorso di query, i descrittori di proprietà sono ancora disponibili per il data binding, ma le proprietà stesse restituiscono valori Null. In questo caso, gli oggetti correlati devono essere caricati in modo esplicito per visualizzare i relativi valori. Per altre informazioni, vedere Caricamento di oggetti correlati.