EntityDataSource.Include Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ruft den Ausdruck ab, der die verwandten Objekte angibt, die in den Abfrageergebnissen enthalten sein sollen, oder legt diesen fest.

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 von Abfragepfaden zur Rückgabe in den Abfrageergebnissen.

Beispiele

Das folgende XML-Markup definiert einen Abfrage Pfad, der Objekte zurückgibt, SalesOrderHeader die sich auf das zurückgegebene Contact Objekt beziehen. Dabei SalesOrderHeader werden auch die zugehörigen SalesOrderDetail - Address Objekte und-Objekte 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 mit dem folgenden ObjectQuery<T> Namen identisch 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-Steuer Elements gibt eine durch Trennzeichen EntityDataSource getrennte Liste von Abfrage Pfaden an, die die Objekte definieren, die zusammen mit dem speziell abgefragten Objekt zurückgegeben werden. Jeder durch Trennzeichen getrennte Wert in der Zeichenfolge wird nicht geändert, sondern als separater aufzurufende Methode einer-Methode, die Include ObjectQuery<T> von der Entity Framework ausgeführt wird. Diese Abfrage ist die Quelle der Daten, die vom-Steuerelement reguliert werden EntityDataSource . Die- Include Eigenschaft ist das-Argument, das auf das angewendet wird, ObjectQuery<T> bevor es ausgeführt wird.

Die für die-Eigenschaft angegebene Zeichenfolge Include verwendet das gleiche Format wie die Zeichenfolge, die an die- Include Methode von übergeben wird ObjectQuery<T> . Beispiele für die Verwendung von Abfrage Pfaden zum automatischen Laden verbundener Objekte finden Sie unter Gewusst wie: Verwenden von Abfrage Pfaden zum Strukturieren von Ergebnissen.

Wenn die Include Eigenschaft zum Angeben von Abfrage Pfaden verwendet wird, können die Eigenschaften der verknüpften Entitäten nur für schreibgeschützte Daten Bindungen verwendet werden. Wenn verknüpfte Objekte nicht explizit im Abfrage Pfad enthalten sind, sind die Eigenschafts Deskriptoren für die Datenbindung weiterhin verfügbar, die Eigenschaften selbst geben jedoch 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.