SqlDataSource.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(DataSourceSelectArguments) 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 en de SqlDataSource modus is ingeschakeld DataReader .
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u gegevens ophaalt uit de Northwind-database en filtert met behulp van een FilterExpression tekenreeks en de FilterParameters verzameling. De FilterExpression eigenschap wordt toegepast wanneer de Select methode wordt uitgevoerd om gegevens op te halen. In dit voorbeeld bevat het FilterExpression een tijdelijke aanduiding voor een filterparameter, die zich in de FilterParameters verzameling bevindt. Bovendien is de filterparameter een ControlParameter object dat is gebonden aan de SelectedValue eigenschap van het DropDownList besturingselement. Omdat de eigenschap van het DropDownList besturingselement is AutoPostBack ingesteld trueop, zorgt elke wijziging in de selectie voor het DropDownList besturingselement ervoor dat de pagina informatie weer op de server plaatst 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 FilterExpression eigenschapswaarde is een notatietekenreeksexpressie (een tekenreeks die door de String.Format methode wordt verwerkt) die gebruikmaakt van de waarden in de FilterExpression verzameling voor vervangingsparameters die in de tekenreeks zijn opgenomen. De syntaxis van de filterexpressie is dezelfde syntaxis die door de RowFilter eigenschap wordt geaccepteerd, omdat de filterexpressie wordt toegepast op de RowFilter eigenschap van het DataView object dat wordt geretourneerd door het uitvoeren van de Select methode. Zie Expression voor meer informatie.
Als u parameters toevoegt aan de FilterParameters verzameling, kunt u ook tijdelijke aanduidingen voor opmaaktekenreeksen opnemen (bijvoorbeeld "{0}") in de expressie om parameterwaarden te vervangen. De tijdelijke aanduidingen worden vervangen volgens de index van de parameter in de FilterParameters verzameling. Als een object in de FilterParameters verzameling is null, wordt het object vervangen door een lege tekenreeks.
U kunt parameters opnemen in de FilterExpression eigenschap. Als de parameter een tekenreeks of tekentype 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 de DataSet modus.
De FilterExpression eigenschap wordt gedelegeerd aan de FilterExpression eigenschap van het SqlDataSourceView object dat is gekoppeld aan het SqlDataSource besturingselement.
