EntityDataSource.Include Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Dient zum Abrufen oder Festlegen des Ausdrucks, der die zugehörigen Objekte angibt, die in die Abfrageergebnisse eingeschlossen werden sollen.

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

Eigenschaftswert

String

Durch Trennzeichen getrennte Liste der Abfragepfade, die in den Abfrageergebnissen zurückgegeben werden sollen.

Beispiele

Das folgende XML-Markup definiert einen Abfragepfad, der Objekte zurückgibt SalesOrderHeader , die mit dem zurückgegebenen Contact Objekt zusammenhängen. Bei jedem SalesOrderHeaderwerden die zugehörigen SalesOrderDetail und Address Objekte ebenfalls zurückgegeben.

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

Das vorherige XML-Beispiel ist identisch mit dem folgenden ObjectQuery<T> Namen customers:

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

Hinweise

Die Include Eigenschaft des EntityDataSource Steuerelements gibt eine durch Trennzeichen getrennte Liste von Abfragepfaden an, die die Objekte definieren, die zusammen mit dem speziell abgefragten Objekt zurückgegeben werden. Jeder durch Trennzeichen getrennte Wert in der Zeichenfolge wird ohne Änderung als separater Aufruf der Include Methode eines ObjectQuery<T> vom Entity Framework ausgeführten Elements übergeben. Diese Abfrage ist die Quelle der durch das EntityDataSource Steuerelement regulierten Daten. Die Include Eigenschaft ist das Argument, das vor der ObjectQuery<T> Ausführung angewendet wird.

Die für die Include Eigenschaft bereitgestellte Zeichenfolge verwendet das gleiche Format wie die Zeichenfolge, die an die Include Methode von ObjectQuery<T>übergeben wird. Beispiele für die Verwendung von Abfragepfaden zum automatischen Laden verwandter Objekte finden Sie unter How to: Use Query Paths to Shape Results.

Wenn die Include Eigenschaft zum Angeben von Abfragepfaden verwendet wird, können die Eigenschaften der zugehörigen Entitäten nur für schreibgeschützte Datenbindung verwendet werden. Wenn verwandte Objekte nicht explizit im Abfragepfad enthalten sind, sind die Eigenschaftendeskriptoren weiterhin für die Datenbindung verfügbar, aber die Eigenschaften selbst geben NULL-Werte zurück. In diesem Fall müssen die zugehörigen Objekte explizit geladen werden, um ihre Werte anzuzeigen. Weitere Informationen finden Sie unter Laden verwandter Objekte.