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 SalesOrderHeaderoggetto , 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 è uguale 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 controllo specifica un elenco delimitato da virgole dei percorsi di EntityDataSource query che definiscono gli oggetti restituiti insieme all'oggetto 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 EntityDataSource dei dati regolamentati dal controllo. La Include proprietà è l'argomento applicato all'oggetto prima dell'esecuzione ObjectQuery<T> .

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

Quando la Include proprietà viene usata per specificare i percorsi di query, le proprietà delle entità correlate possono essere usate solo per il data binding di sola lettura. Se gli oggetti correlati non sono inclusi in modo esplicito nel percorso di query, i descrittori delle 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.