LinqDataSource.WhereParameters 属性

获取参数的集合，用于创建 Where 子句。

命名空间:     System.Web.UI.WebControls
程序集:   System.Web.Extensions（位于 System.Web.Extensions.dll）

语法

C#

C++

F#

VB

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[BrowsableAttribute(false)]
public ParameterCollection WhereParameters { get; }

属性值

Type:  System.Web.UI.WebControls.ParameterCollection

用于创建 Where 参数的集合中的子句 Where 属性。

实现

IDynamicDataSource.WhereParameters

备注

LinqDataSource 控件使用中的参数 WhereParameters 集合以创建 Where 子句在运行时。 您将参数添加到 WhereParameters 集合时您想要以编程方式设置一个或多个条件，在 Where 子句。 例如，您可能会搜索姓氏等于的值记录在数据库表 TextBox 控件。 在这种情况下，您将参数添加到WhereParameters 文本框的值的集合。

如果不需要在运行时设置一个值，在 Where 子句中，您不需要使用 WhereParameters 集合。 您可以定义字段后，若要检索在 Where 属性。 例如，若要从数据库表中返回其中 LastName 等于"Adams"在标记中，设置 Where 属性设置为 'LastName = "Adams"' 不带任何参数。

若要设置的值在 WhereParameters 集合中，为每个参数分配一个名称，然后添加中的占位符 Where 属性中的为该参数。 在 Where 子句中，每个参数名称的前面加符号 @。

示例

下面的示例演示如何使用 WhereParameters 集合以动态地创建 Where 子句。 LinqDataSource 控制权将返回的值的所有记录 Price 大于由用户在选择的值的列 DropDownList 控件。

C#

VB

<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>

版本信息

.NET Framework 
自 3.5 起可用