LinqDataSource.WhereParameters Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.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

Eine Auflistung der Parameter, die zum Erstellen der Where-Klausel in der Where-Eigenschaft verwendet werden.

Implementiert

WhereParameters
Attribute
BrowsableAttribute PersistenceModeAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie die Auflistung verwenden, um die WhereParameters Where-Klausel dynamisch zu erstellen. Das LinqDataSource Steuerelement gibt alle Datensätze mit einem Wert in der Spalte zurück, die Price größer als der vom Benutzer in einem DropDownList Steuerelement ausgewählte Wert ist.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price>@UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > @UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Hinweise

Das LinqDataSource Steuerelement verwendet Parameter in der WhereParameters Auflistung, um die Where-Klausel zur Laufzeit zu erstellen. Sie fügen der WhereParameters Auflistung Parameter hinzu, wenn Sie eine oder mehrere der Bedingungen in der Where-Klausel programmgesteuert festlegen möchten. Beispielsweise können Sie eine Datenbanktabelle nach Datensätzen mit einem Nachnamen suchen, der dem Wert eines TextBox Steuerelements entspricht. In diesem Fall fügen Sie der WhereParameters Auflistung für den Textfeldwert einen Parameter hinzu.

Wenn Sie keinen Wert zur Laufzeit in der Where-Klausel festlegen müssen, müssen Sie die WhereParameters Auflistung nicht verwenden. Sie können die Felder definieren, die in der Where Eigenschaft abgerufen werden sollen. Wenn Sie beispielsweise Werte aus einer Datenbanktabelle zurückgeben möchten, in der LastName "Adams" im Markup entspricht, legen Sie die Where Eigenschaft ohne Parameter fest 'LastName = "Adams"' .

Zum Festlegen von Werten in der WhereParameters Auflistung weisen Sie jedem Parameter einen Namen zu und fügen dann einen Platzhalter in der Where Eigenschaft für diesen Parameter hinzu. Stellen Sie in der Where-Klausel jeden Parameternamen mit dem @-Symbol vor.

Gilt für