Aracılığıyla paylaş

SqlDataSourceView.FilterExpression Özellik

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

Özel durumlar

NotSupportedException

FilterExpression özelliği, modundayken 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 FilterExpressionSqlDataSource özelliği, veri almak için yöntem yürütülürken her zaman Select uygulanır. Bu örnekte özelliği, FilterExpression koleksiyonda FilterParameters yer alan filtre parametresi için bir yer tutucu içerir. Bu örnekte, filtre parametresi denetimin SelectedValue özelliğine DropDownList bağlı bir ControlParameter nesnedir. Denetimin özelliği olarak trueayarlandığındanDropDownList, seçimdeki DropDownList herhangi bir değişiklik sayfanın sunucuya gönderilmesine 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

özelliği için FilterExpression kullanılan söz dizimi, biçim dizesi stilinde 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şaretleri gerekli değildir.

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 herhangi bir filtre parametresi değerini 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 bir güvenlik önlemi olarak özelliğini kullanıyorsanız FilterExpression , filtreleme gerçekleşmeden önce parametre değerlerini doğrulamanız gerekir.

Şunlara uygulanır

Ayrıca bkz.