SqlDataSource.FilterExpression Свойство

Определение

Возвращает или задает выражение фильтра для применения при вызове метода Select(DataSourceSelectArguments).

public:
 property System::String ^ FilterExpression { System::String ^ get(); void set(System::String ^ value); };
public string FilterExpression { get; set; }
member this.FilterExpression : string with get, set
Public Property FilterExpression As String

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

String

Строка, которая представляет выражение фильтрации, применяемое при получении данных с помощью метода Select(DataSourceSelectArguments).

Исключения

Установлено свойство FilterExpression; SqlDataSource используется в режиме DataReader.

Примеры

В следующем примере кода показано, как получить данные из базы данных Northwind и отфильтровать их с помощью FilterExpression строки и FilterParameters коллекции. FilterExpressionСвойство применяется при каждом Select выполнении метода для получения данных. В этом примере FilterExpression содержит заполнитель для параметра фильтра, который содержится в FilterParameters коллекции. Кроме того, параметр фильтра — это ControlParameter объект, привязанный к SelectedValue свойству DropDownList элемента управления. Так как DropDownList свойство элемента управления имеет AutoPostBack значение true , любое изменение в выделении DropDownList элемента управления приводит к тому, что страница будет отправлять сведения обратно на сервер и GridView элемент управления для повторной привязки к элементу управления источника данных с новым фильтром.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected="True">Sales Representative</asp:ListItem>
                <asp:ListItem>Sales Manager</asp:ListItem>
                <asp:ListItem>Vice President, Sales</asp:ListItem>
            </asp:DropDownList></p>

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource>

            <p><asp:GridView
                id="GridView1"
                runat="server"
                DataSourceID="SqlDataSource1"
                AutoGenerateColumns="False">
                <columns>
                    <asp:BoundField Visible="False" DataField="EmployeeID" />
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                </columns>
            </asp:GridView></p>

        </form>
    </body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <p>Show all employees with the following title:
            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                AutoPostBack="True">
                <asp:ListItem Selected="True">Sales Representative</asp:ListItem>
                <asp:ListItem>Sales Manager</asp:ListItem>
                <asp:ListItem>Vice President, Sales</asp:ListItem>
            </asp:DropDownList></p>

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource>

            <p><asp:GridView
                id="GridView1"
                runat="server"
                DataSourceID="SqlDataSource1"
                AutoGenerateColumns="False">
                <columns>
                    <asp:BoundField Visible="False" DataField="EmployeeID" />
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                </columns>
            </asp:GridView></p>

        </form>
    </body>
</html>

Комментарии

FilterExpressionЗначением свойства является строковое выражение формата (строка, обрабатываемая String.Format методом), которая использует значения в FilterExpression коллекции для всех параметров подстановки, включенных в строку. Синтаксис критерия фильтра — это тот же синтаксис, который принимается RowFilter свойством, поскольку критерий фильтра применяется к RowFilter свойству DataView объекта, который возвращается из выполнения Select метода. Для получения дополнительной информации см. Expression.

При добавлении параметров в FilterParameters коллекцию можно также включить заполнители строки форматирования (например, "{0}") в выражении для замены значений параметров). Заполнители заменяются в соответствии с индексом параметра в FilterParameters коллекции. Если объект в FilterParameters коллекции имеет значение null , объект будет заменен пустой строкой.

В свойство можно включить параметры FilterExpression . Если параметр является строковым или символьным типом, заключите параметр в одинарные кавычки. Если параметр имеет числовой тип, кавычки не требуются. FilterParametersКоллекция содержит параметры, которые оцениваются для заполнителей, найденных в FilterExpression свойстве.

SqlDataSourceЭлемент управления поддерживает фильтрацию данных только в DataSet режиме.

FilterExpressionСвойство делегирует FilterExpression свойство SqlDataSourceView объекта, связанного с SqlDataSource элементом управления.

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

См. также раздел