SqlDataSource.FilterExpression Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

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

String

yöntemi kullanılarak Select(DataSourceSelectArguments) veriler alındığında uygulanan bir filtreleme ifadesini temsil eden dize.

Özel durumlar

NotSupportedException

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

Şunlara uygulanır

Ayrıca bkz.