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, set
Public Property FilterExpression As String
Özellik Değeri
yöntemi kullanılarak Select(DataSourceSelectArguments) veri 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 özelliği, veri almak için yöntem yürütürken her zaman Select uygulanır. Bu örnekte , koleksiyonunda FilterExpression FilterParameters yer alan bir filtre parametresi için yer tutucu içerir. Ayrıca, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin AutoPostBack özelliği olarak ayarlandığından DropDownList true
, 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.
<!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
Özellik FilterExpression 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öntemin yürütülmesinden döndürülen nesnenin özelliğine RowFilter DataView uygulandığından, filtre ifadesi 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 parametrenin 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şareti gerekmez. 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ğine temsilci FilterExpression atarSqlDataSource.