SqlDataSource.FilterExpression Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Yöntem çağrıldığında Select(DataSourceSelectArguments) uygulanan bir filtreleme ifadesi alır veya ayarlar.
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 StringÖzellik Değeri
yöntemi kullanılarak Select(DataSourceSelectArguments) veriler alındığında uygulanan bir filtreleme ifadesini temsil eden dize.
Özel durumlar
FilterExpression özelliği ayarlandı ve SqlDataSource modundaDataReader.
Örnekler
Aşağıdaki kod örneği, Northwind veritabanından veri almayı ve bir FilterExpression dize ile koleksiyonu kullanarak filtrelemeyi FilterParameters gösterir.
FilterExpression özellik, veri almak için yöntemi yürütülür her zaman Select uygulanır. Bu örnekte , FilterExpression bir filtre parametresi için koleksiyonda FilterParameters yer alan bir yer tutucu içerir. Ayrıca, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin özelliği olarak trueayarlandığındanDropDownList, denetim seçimindeki DropDownList herhangi bir değişiklik sayfanın bilgileri sunucuya geri göndermesine ve denetimin GridView yeni filtreyle veri kaynağı denetimine yeniden bağlanmasına neden olur.AutoPostBack
<!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>
Açıklamalar
FilterExpression Özellik değeri, dizeye dahil edilen değiştirme parametreleri için koleksiyondaki FilterExpression değerleri kullanan bir biçim dizesi ifadesidir (yöntemi tarafından String.Format işlenen bir dize). Filtre ifadesi, yöntemi yürütülürken döndürülen nesnenin özelliğine RowFilter uygulandığından, filtre ifadesinin DataView söz dizimi özelliği tarafından RowFilter kabul edilen söz dizimi ile Select aynıdır. Daha fazla bilgi için bkz. Expression.
Koleksiyona FilterParameters parametre eklerseniz, biçim dizesi yer tutucularını da ekleyebilirsiniz (örneğin, "{0}") parametre değerlerinin yerine kullanılacak ifadeye). Yer tutucular, koleksiyondaki parametresinin FilterParameters dizinine göre değiştirilir. Koleksiyondaki FilterParameters bir nesne ise null, nesne boş bir dizeyle değiştirilir.
Özelliğine FilterExpression parametreler ekleyebilirsiniz. Parametre bir dize veya karakter türüyse, parametreyi tek tırnak içine alın. Parametre sayısal bir türse tırnak işaretleri gerekli değildir. Koleksiyon, FilterParameters özelliğinde FilterExpression bulunan yer tutucular için değerlendirilen parametreleri içerir.
Denetim SqlDataSource yalnızca moddayken verileri filtrelemeyi DataSet destekler.
özelliği, FilterExpression denetimle ilişkili nesnenin SqlDataSourceView özelliğini temsil ederSqlDataSource.FilterExpression
