SqlDataSource.FilterExpression Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví filtrovací výraz, který se použije při Select(DataSourceSelectArguments) zavolání metody.
public:
property System::String ^ FilterExpression { System::String ^ get(); void set(System::String ^ value); };public string FilterExpression { get; set; }member this.FilterExpression : string with get, setPublic Property FilterExpression As StringHodnota vlastnosti
Řetězec, který představuje výraz filtrování použitý při načtení dat pomocí Select(DataSourceSelectArguments) metody.
Výjimky
Vlastnost FilterExpression byla nastavena a SqlDataSource je v DataReader režimu.
Příklady
Následující příklad kódu ukazuje, jak načíst data z databáze Northwind a filtrovat je pomocí FilterExpression řetězce a FilterParameters kolekce. Vlastnost FilterExpression se použije při každém Select spuštění metody pro načtení dat. V tomto příkladu FilterExpression obsahuje zástupný symbol pro parametr filtru, který je obsažen v kolekci FilterParameters . Kromě toho je ControlParameter parametr filtru objekt, který je vázán na SelectedValue vlastnost DropDownList ovládacího prvku. Vzhledem k tomu, že DropDownList ovládací prvek má nastavenou AutoPostBack vlastnost true, jakákoli změna výběru DropDownList ovládacího prvku způsobí, že stránka publikuje informace zpět na server a GridView ovládací prvek, který se má znovu připojit k ovládacímu prvku zdroje dat pomocí nového filtru.
<!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>
Poznámky
Hodnota FilterExpression vlastnosti je formátovací řetězcový výraz (řetězec zpracovaný metodou String.Format ), který používá hodnoty v FilterExpression kolekci pro všechny parametry nahrazení zahrnuté v řetězci. Syntaxe výrazu filtru je stejná syntaxe, která je přijata vlastností RowFilter , protože výraz filtru se použije na RowFilter vlastnost objektu DataView , který je vrácen z provádění Select metody. Další informace najdete na webu Expression.
Pokud do kolekce přidáte parametry FilterParameters , můžete také zahrnout zástupné symboly řetězce formátu (například "{0}") ve výrazu, který nahradí hodnoty parametrů. Zástupné symboly se nahradí podle indexu parametru v kolekci FilterParameters . Pokud je nullobjekt v kolekci FilterParameters , objekt se nahradí prázdným řetězcem.
Do vlastnosti můžete zahrnout parametry FilterExpression . Pokud je parametr řetězcem nebo typem znaku, uzavřete parametr do jednoduchých uvozovek. Uvozovky nejsou povinné, pokud je parametr číselným typem. Kolekce FilterParameters obsahuje parametry, které jsou vyhodnoceny pro zástupné symboly nalezené ve FilterExpression vlastnosti.
Ovládací SqlDataSource prvek podporuje filtrování dat pouze v DataSet režimu.
Vlastnost FilterExpression deleguje na FilterExpression vlastnost objektu SqlDataSourceView , který je přidružen k SqlDataSource ovládacího prvku.
