EntityDataSource.WhereParameters Eigenschaft

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

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

Implementiert

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: