SqlDataSourceFilteringEventArgs SqlDataSourceFilteringEventArgs SqlDataSourceFilteringEventArgs SqlDataSourceFilteringEventArgs Class

Definition

Stellt Daten für das Filtering-Ereignis des SqlDataSource-Steuerelements bereit.Provides data for the Filtering event of the SqlDataSource control.

public ref class SqlDataSourceFilteringEventArgs : System::ComponentModel::CancelEventArgs
public class SqlDataSourceFilteringEventArgs : System.ComponentModel.CancelEventArgs
type SqlDataSourceFilteringEventArgs = class
    inherit CancelEventArgs
Public Class SqlDataSourceFilteringEventArgs
Inherits CancelEventArgs
Vererbung
SqlDataSourceFilteringEventArgsSqlDataSourceFilteringEventArgsSqlDataSourceFilteringEventArgsSqlDataSourceFilteringEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Daten aus der Northwind-Datenbank abgerufen und mithilfe FilterExpression von und FilterParametersgefiltert werden.The following code example demonstrates how to retrieve data from the Northwind database and filter it using a FilterExpression and FilterParameters. Der FilterExpression Select von wird immer dann angewendet, wenn die-Methode ausgeführt wird, um Daten abzurufen. SqlDataSourceThe FilterExpression of the SqlDataSource is applied anytime the Select method is executed to retrieve data. In diesem Beispiel FilterExpression enthält ein Platzhalter für einen Filter Parameter, der in der FilterParameters -Auflistung enthalten ist.In this example, the FilterExpression contains a placeholder for a filter parameter, which is contained in the FilterParameters collection. Im- Label Ereignis wird der Filter-Parameter in einem-Steuerelement angezeigt. FilteringIn the Filtering event, the filter parameter is displayed in a Label control.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    //Protected Sub SqlDataSource1_Filtering(ByVal sender As Object, _
    //    ByVal e As System.Web.UI.WebControls.SqlDataSourceFilteringEventArgs)
    //    Label1.Text = e.ParameterValues(0).ToString()
    //End Sub


    protected void SqlDataSource1_Filtering(object sender, SqlDataSourceFilteringEventArgs e)
    {
        Label1.Text = e.ParameterValues[0].ToString();
    }
</script>

<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>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:NorthwindConnection %>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'" OnFiltering="SqlDataSource1_Filtering">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource><br />

            <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>
                <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>

        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub SqlDataSource1_Filtering(ByVal sender As Object, _
        ByVal e As System.Web.UI.WebControls.SqlDataSourceFilteringEventArgs)
        Label1.Text = e.ParameterValues(0).ToString()
    End Sub
</script>

<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>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:NorthwindConnection %>"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
                FilterExpression="Title='{0}'" OnFiltering="SqlDataSource1_Filtering">
                <FilterParameters>
                    <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/>
                </FilterParameters>
            </asp:SqlDataSource><br />

            <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>
                <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>

        </form>
    </body>
</html>

Hinweise

Die SqlDataSourceFilteringEventArgs -Klasse wird verwendet, um Daten an Filtering den-Ereignishandler SqlDataSource des-Steuer Elements zu übergeben.The SqlDataSourceFilteringEventArgs class is used to pass data to the Filtering event handler of the SqlDataSource control. Die ParameterValues -Eigenschaft ermöglicht den Zugriff auf die Filter Parameterwerte, bevor der Filter Vorgang durchgeführt wird.The ParameterValues property provides access to the filter parameter values before the filtering operation is performed. Sie können die Select -Methode ObjectDataSourceFilteringEventArgs abbrechen, indem Cancel Sie die-Eigenschaft truevon auf festlegen.You can cancel the Select method by setting the Cancel property of the ObjectDataSourceFilteringEventArgs to true. Das Filtern wird unterstützt DataSourceMode , wenn die-Eigenschaft DataSet auf den-Wert festgelegt ist.Filtering is supported when the DataSourceMode property is set to the DataSet value.

Konstruktoren

SqlDataSourceFilteringEventArgs(IOrderedDictionary) SqlDataSourceFilteringEventArgs(IOrderedDictionary) SqlDataSourceFilteringEventArgs(IOrderedDictionary) SqlDataSourceFilteringEventArgs(IOrderedDictionary)

Initialisiert eine neue Instanz der SqlDataSourceFilteringEventArgs-Klasse unter Verwendung des angegebenen Objekts.Initializes a new instance of the SqlDataSourceFilteringEventArgs class by using the specified object.

Eigenschaften

Cancel Cancel Cancel Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
ParameterValues ParameterValues ParameterValues ParameterValues

Ruft ein IOrderedDictionary-Objekt ab, das den Zugriff auf die Parameter-Objekte der SqlDataSource-Klasse ermöglicht.Gets an IOrderedDictionary object that provides access to the Parameter objects of the SqlDataSource class.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch