EntityDataSource.WhereParameters Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Entity.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Auflistung von Parametern ab, die zum Erstellen der Where-Klausel verwendet werden.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ WhereParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection WhereParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property WhereParameters As ParameterCollection

Eigenschaftswert

ParameterCollection

Die Parameter, die zum Erstellen der Where-Klausel verwendet werden.

Implementiert

WhereParameters

Attribute: BrowsableAttribute PersistenceModeAttribute

Beispiele

Das XML-Markup im folgenden Beispiel in einer ASPX-Datei ruft einen Wert aus einem Steuerelement ab und übergibt ihn als Parameter an die Where -Eigenschaft.

<asp:EntityDataSource ID="SalesOrderHeader" runat="server"
  ConnectionString="name=AdventureWorksEntities"
  DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
  EnableInsert="True" EnableUpdate="True" EntitySetName="SalesOrderHeader"
  EntityTypeFilter="" OrderBy="it.TotalDue DESC" Select=""
   Where="it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost">
  <WhereParameters>
    <asp:ControlParameter ControlID="costLimit" DbType="Int32"
      DefaultValue="2500" Name="ordercost" PropertyName="Text" />
  </WhereParameters>
</asp:EntityDataSource>

Das vorherige XML-Beispiel entspricht dem folgenden ObjectQuery<T> mit dem Namen onlineOrders:

ObjectQuery<SalesOrderHeader> onlineOrders =
      context.SalesOrderHeader
       .Where("it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost",
         new ObjectParameter("ordercost", orderCost))
        .OrderBy("it.TotalDue DESC");

Hinweise

Wie die Where -Methode der ObjectQuery<T> -Klasse können Parameter an das Prädikat übergeben werden, das der Where -Eigenschaft zugewiesen ist. Die WhereParameters -Eigenschaft des EntityDataSource -Steuerelements gibt ein ParameterCollection an, das die Parameter enthält, die für die WHERE-Klausel der Abfrage angegeben werden sollen. Die WhereParameters -Eigenschaft verwendet benannte Argumente, um auf die Parameter zu verweisen, die in der Zeichenfolge angegeben sind, die für die Where -Eigenschaft angegeben wird.

Wenn die WhereParameters Eigenschaft nicht festgelegt ist, wird keine Parameterersetzung vorgenommen. Alle Parameternamen in der WHERE-Klausel, denen das Symbol "@" vorangestellt ist, müssen einen übereinstimmenden Namen im ParameterCollectionaufweisen. Null-Werte sind für Parameter in einem ParameterCollectionnicht zulässig.

Gilt für:

Freigeben über