Aracılığıyla paylaş

SqlDataSourceView.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 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) veri alındığında uygulanan bir filtreleme ifadesini temsil eden dize.

Özel durumlar

NotSupportedException

FilterExpression özelliği, modunda olduğunda SqlDataSource ayarlanmıştırDataReader.

Örnekler

Aşağıdaki kod örneği, Northwind veritabanından veri almayı ve ve FilterParameters özelliklerini kullanarak verileri filtrelemeyi FilterExpression gösterir. Denetimin FilterExpression SqlDataSource özelliği, veri almak için yöntem her yürütildiğinde uygulanır Select . Bu örnekte özelliği, FilterExpression koleksiyonda FilterParameters yer alan bir filtre parametresi için yer tutucu içerir. Bu örnekte, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin DropDownList AutoPostBack özelliği olarak ayarlandığından true, seçimdeki DropDownList herhangi bir değişiklik sayfanın sunucuya 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

özelliği için FilterExpression kullanılan söz dizimi, biçim dizesi stili bir söz dizimidir. özelliğine FilterExpression parametreler ekleyebilirsiniz. Parametrenin türü dize veya karakterse, 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 DataSet verileri filtrelemeyi destekler.

özelliğinin FilterExpression değeri görünüm durumunda depolanır.

Önemli

İstemciden aldığınız tüm filtre parametresi değerlerini doğrulamanız gerekir. Çalışma zamanı, parametre değerini filtre ifadesiyle değiştirerek yöntemi tarafından Select döndürülen nesneye DataView uygular. Döndürülen öğe sayısını sınırlamak için özelliğini bir güvenlik önlemi olarak kullanıyorsanız FilterExpression , filtreleme gerçekleşmeden önce parametre değerlerini doğrulamanız gerekir.

Şunlara uygulanır

Ayrıca bkz.