SqlDataSourceView.FilterExpression Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een filterexpressie opgevraagd of ingesteld die wordt toegepast wanneer de Select methode wordt aangeroepen.
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 StringWaarde van eigenschap
Een tekenreeks die een filterexpressie vertegenwoordigt die wordt toegepast wanneer gegevens worden opgehaald met behulp van de Select(DataSourceSelectArguments) methode.
Uitzonderingen
De FilterExpression eigenschap is ingesteld wanneer de SqlDataSource modus zich in de DataReader modus bevindt.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u gegevens ophaalt uit de Northwind-database en filtert met behulp van de FilterExpression en FilterParameters eigenschappen. De FilterExpression eigenschap van het SqlDataSource besturingselement wordt toegepast wanneer de Select methode wordt uitgevoerd om gegevens op te halen. In dit voorbeeld bevat de FilterExpression eigenschap een tijdelijke aanduiding voor een filterparameter, die zich in de FilterParameters verzameling bevindt. In dit voorbeeld is de filterparameter een ControlParameter object dat is gebonden aan de SelectedValue eigenschap van het DropDownList besturingselement. Omdat voor het DropDownList besturingselement de eigenschap is AutoPostBack ingesteld true, zorgt elke wijziging in de DropDownList selectie ervoor dat de pagina wordt geplaatst op de server en dat het GridView besturingselement opnieuw wordt gekoppeld aan het besturingselement voor de gegevensbron met het nieuwe filter.
<!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>
Opmerkingen
De syntaxis die voor de FilterExpression eigenschap wordt gebruikt, is een syntaxis in tekenreeksstijl opmaken. U kunt parameters opnemen in de FilterExpression eigenschap. Als het type van de parameter tekenreeks of teken is, plaatst u de parameter tussen enkele aanhalingstekens. Aanhalingstekens zijn niet vereist als de parameter een numeriek type is.
De FilterParameters verzameling bevat de parameters die worden geëvalueerd voor de tijdelijke aanduidingen die in de FilterExpression eigenschap worden gevonden.
Het SqlDataSource besturingselement biedt alleen ondersteuning voor het filteren van gegevens in DataSet de modus.
De waarde van de FilterExpression eigenschap wordt opgeslagen in de weergavestatus.
Important
U moet een filterparameterwaarde valideren die u van de client ontvangt. De runtime vervangt de parameterwaarde in de filterexpressie en past deze toe op het DataView object dat door de Select methode wordt geretourneerd. Als u de FilterExpression eigenschap gebruikt als een beveiligingsmaatregel om het aantal geretourneerde items te beperken, moet u de parameterwaarden valideren voordat het filteren plaatsvindt.
