EntityDataSource.WhereParameters Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

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 ruft in einer .aspx-Datei 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 ist identisch mit dem folgenden ObjectQuery<T> 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 eine ParameterCollection , die 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 vor dem Symbol "@" müssen einen übereinstimmenden Namen in der .ParameterCollection Nullwerte sind für Parameter in einer ParameterCollection.