Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

SqlDataSourceView.FilterExpression-Eigenschaft

.NET Framework 4.5

Andere Versionen

Ruft einen Filterausdruck ab, der beim Aufruf der Select-Methode angewendet wird, oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public string FilterExpression { get; set; }

Eigenschaftswert

Typ: System.String
Eine Zeichenfolge, die einen Filterausdruck darstellt, der beim Datenabruf mithilfe der Select-Methode verwendet wird.

Ausnahmen

Ausnahme	Bedingung
NotSupportedException	Die FilterExpression-Eigenschaft wurde festgelegt, während sich die SqlDataSource im DataReader-Modus befand.

Hinweise

Die für die FilterExpression-Eigenschaft verwendete Syntax ist eine Formatzeichenfolgen-Syntax. Sie können Parameter in der FilterExpression-Eigenschaft einschließen. Falls es sich bei dem Parameter um einen Zeichenfolgen- oder Zeichentyp handelt, muss er in einfache Anführungszeichen eingeschlossen werden. Es sind keine Anführungszeichen erforderlich, wenn es sich um einen numerischen Parametertyp handelt.

Die FilterParameters-Auflistung enthält die Parameter, die für die in der FilterExpression-Eigenschaft gefundenen Platzhalter ausgewertet werden.

Das SqlDataSource-Steuerelement unterstützt das Filtern von Daten nur, wenn es sich im DataSet-Modus befindet.

Der Wert der FilterExpression-Eigenschaft wird im Ansichtszustand gespeichert.

Sicherheitshinweis
Sie müssen jeden vom Client empfangenen Filterparameterwert validieren. Zur Laufzeit wird der Parameterwert im Filterausdruck einfach ersetzt und auf das DataView-Objekt angewendet, das von der Select-Methode zurückgegeben wird. Wenn Sie die FilterExpression-Eigenschaft als Sicherheitsmaßnahme zum Einschränken der Anzahl der zurückgegebenen Elemente verwenden, müssen die Parameterwerte vor dem Ausführen des Filters validiert werden.

Sicherheitshinweis

Sie müssen jeden vom Client empfangenen Filterparameterwert validieren. Zur Laufzeit wird der Parameterwert im Filterausdruck einfach ersetzt und auf das DataView-Objekt angewendet, das von der Select-Methode zurückgegeben wird. Wenn Sie die FilterExpression-Eigenschaft als Sicherheitsmaßnahme zum Einschränken der Anzahl der zurückgegebenen Elemente verwenden, müssen die Parameterwerte vor dem Ausführen des Filters validiert werden.

Beispiele

Im folgenden Codebeispiel wird das Abrufen von Daten aus der Datenbank Northwind sowie das Filtern dieser Daten mithilfe der FilterExpression-Eigenschaft und der FilterParameters-Eigenschaft veranschaulicht. Die FilterExpression-Eigenschaft des SqlDataSource-Steuerelements wird immer dann angewendet, wenn die Select-Methode ausgeführt wird, um Daten abzurufen. In diesem Beispiel enthält die FilterExpression-Eigenschaft einen Platzhalter für einen Filterparameter, der in der FilterParameters-Auflistung enthalten ist. In diesem Beispiel handelt es sich bei dem Filterparameter um ein ControlParameter-Objekt, das an die SelectedValue-Eigenschaft des DropDownList-Steuerelements gebunden ist. Da die AutoPostBack-Eigenschaft des DropDownList-Steuerelements auf true festgelegt wurde, bewirkt jede Änderung in der DropDownList-Auswahl, dass die Seite Informationen an den Server sendet und das GridView-Steuerelement mit dem neuen Filter erneut an das Datenquellen-Steuerelement gebunden wird.


<!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>

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Siehe auch

Referenz

SqlDataSourceView Klasse

System.Web.UI.WebControls-Namespace

FilterParameters

DataSourceMode

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN