LinqDataSource.WhereParameters Свойство

Определение

Возвращает коллекцию параметров, которые используются для создания оператора Where.Gets the collection of parameters that is used to create the Where clause.

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; }
member this.WhereParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property WhereParameters As ParameterCollection

Значение свойства

Коллекцию параметров, которые используются для создания предложения Where в свойстве Where.A collection of the parameters that are used to create the Where clause in the Where property.

Реализации

Атрибуты

Примеры

В следующем примере показано, как использовать коллекцию WhereParameters для динамического создания предложения WHERE.The following example shows how to use the WhereParameters collection to dynamically create the Where clause. Элемент управления LinqDataSource возвращает все записи со значением в столбце Price, которое больше значения, выбранного пользователем в элементе управления DropDownList.The LinqDataSource control returns all the records with a value in the Price column that is greater than the value selected by the user in a DropDownList control.

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

Комментарии

Элемент управления LinqDataSource использует параметры в коллекции WhereParameters для создания предложения WHERE во время выполнения.The LinqDataSource control uses parameters in the WhereParameters collection to create the Where clause at run time. Параметры добавляются в коллекцию WhereParameters, если необходимо программно задать одно или несколько условий в предложении WHERE.You add parameters to the WhereParameters collection when you want to programmatically set one or more of the conditions in the Where clause. Например, можно выполнить поиск записей в таблице базы данных с фамилией, равным значению элемента управления TextBox.For example, you might search a database table for records with a last name equal to the value of a TextBox control. В этом случае вы добавляете параметр в коллекцию WhereParameters для значения текстового поля.In that case, you add a parameter to the WhereParameters collection for the text box value.

Если не нужно задавать значение во время выполнения в предложении WHERE, не нужно использовать коллекцию WhereParameters.If you do not have to set a value at run time in the Where clause, you do not have to use the WhereParameters collection. Можно определить поля для извлечения в свойстве Where.You can define the fields to retrieve in the Where property. Например, чтобы вернуть значения из таблицы базы данных, где LastName равно "Адамс" в разметке, установите для свойства Where значение 'LastName = "Adams"' без каких-либо параметров.For example, to return values from a database table where LastName equals "Adams" in markup, set the Where property to 'LastName = "Adams"' without any parameters.

Чтобы задать значения в коллекции WhereParameters, необходимо назначить имя каждому параметру, а затем добавить заполнитель в свойство Where для этого параметра.To set values in the WhereParameters collection, you assign a name to each parameter and then add a placeholder in the Where property for that parameter. В предложении WHERE перед именем каждого параметра введите символ @.In the Where clause, preface each parameter name with the @ symbol.

Применяется к