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) 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 özelliği, veri almak için yöntem yürütülürken her zaman Select uygulanır. Bu örnekte, koleksiyonunda FilterExpressionFilterParameters yer alan filtre parametresi için bir yer tutucu içerir. Buna ek olarak, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin AutoPostBack özelliği olarak ayarlandığından DropDownListtrue
, 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 söz dizimi, yöntemin yürütülmesinden döndürülen nesnenin özelliğine DataView uygulandığındanRowFilter, özellik 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 parametreleri 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 bulunan FilterExpression yer tutucular için değerlendirilen parametreleri içerir.
Denetim SqlDataSource , verileri yalnızca moddayken filtrelemeyi DataSet destekler.
özelliği, FilterExpression denetimle ilişkilendirilmiş nesnenin SqlDataSourceView özelliğini temsil ederSqlDataSource.FilterExpression