Auf Englisch lesen

Freigeben über

ObjectDataSourceFilteringEventHandler Delegat

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Stellt die Methode dar, die das Filtering-Ereignis des ObjectDataSource-Steuerelements behandelt.

public delegate void ObjectDataSourceFilteringEventHandler(object sender, ObjectDataSourceFilteringEventArgs e);

Parameter

sender
Object

Die Quelle des Ereignisses: ObjectDataSource.

e
ObjectDataSourceFilteringEventArgs

Ein ObjectDataSourceFilteringEventArgs, das die Ereignisdaten enthält.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie gefilterte Daten mithilfe eines ObjectDataSource Steuerelements zum Abrufen von Daten aus einem Geschäftsobjekt der mittleren Ebene und dann mithilfe eines GridView Steuerelements zum Anzeigen der Ergebnisse angezeigt werden. Das zweite Codebeispiel enthält ein Beispiel für ein Geschäftsobjekt der mittleren Ebene, das vom ersten Codebeispiel verwendet wird.

Im folgenden Codebeispiel wird veranschaulicht, wie gefilterte Daten mithilfe eines ObjectDataSource Steuerelements zum Abrufen von Daten aus einem Geschäftsobjekt der mittleren Ebene und anschließend mithilfe eines GridView Steuerelements zum Anzeigen der Ergebnisse angezeigt werden. Das ObjectDataSource -Steuerelement kann Daten nur filtern, wenn die Methode, die die Daten abruft, sie als - DataSet oder DataTable -Objekt abruft. Aus diesem Grund identifiziert die SelectMethod -Eigenschaft eine Geschäftsobjektmethode, die Daten als - DataSet oder DataTable -Objekt abruft.

Das Codebeispiel besteht aus einem TextBox Steuerelement, einem GridView Steuerelement, dem ObjectDataSource Steuerelement und einer Schaltfläche Senden . Standardmäßig wird das TextBox Steuerelement mit dem Namen eines der Mitarbeiter bei Northwind Traders aufgefüllt. Das GridView -Steuerelement zeigt Informationen über den Mitarbeiter an, der durch den Namen im TextBoxidentifiziert wird. Um Daten für einen anderen Mitarbeiter abzurufen, geben Sie im TextBox Steuerelement den vollständigen Namen des Mitarbeiters ein, und klicken Sie dann auf die Schaltfläche Übermitteln .

Die FilterExpression -Eigenschaft gibt einen Ausdruck an, der verwendet wird, um die Daten zu filtern, die von der methode abgerufen werden, die von der SelectMethod -Eigenschaft angegeben wird. Es werden Parameterplatzhalter verwendet, die für die Parameter ausgewertet werden, die in der FilterParameters Auflistung enthalten sind. In diesem Beispiel wird der Parameterplatzhalter in einfache Anführungszeichen (') eingeschlossen, da der Typ des Parameters ein Zeichenfolgentyp ist, der Leerzeichen enthalten kann. Wenn der Typ des Parameters numerisch oder datumsangabe ist, sind anführungszeichen nicht erforderlich. Die FilterParameters Auflistung enthält einen Parameter, ein FormParameter -Objekt, das an das TextBox -Steuerelement gebunden ist.

Wenn im TextBox Steuerelement kein Name angegeben ist, wird der ParameterValues Auflistung ein neuer Parameter hinzugefügt, damit die Suche erfolgreich ist.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ 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 void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
    {
        if (Textbox1.Text == "")
        {
            e.ParameterValues.Clear();
            e.ParameterValues.Add("FullName", "Nancy Davolio");
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

        <!-- Security Note: The ObjectDataSource uses a FormParameter,
             Security Note: which does not perform validation of input from the client. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.CS.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

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

Das folgende Codebeispiel enthält ein Beispiel für ein Geschäftsobjekt der mittleren Ebene, das im vorherigen Codebeispiel verwendet wird. Das Codebeispiel besteht aus zwei grundlegenden Klassen: EmployeeLogic und NorthwindEmployee. Die EmployeeLogic -Klasse kapselt Geschäftslogik, und die NorthwindEmployee -Klasse ist eine Modellklasse, die nur die grundlegenden Funktionen enthält, die zum Laden und Beibehalten von Daten aus der Datenebene erforderlich sind. Der Einfachheit halber erstellt die EmployeeLogic -Klasse einen statischen Satz von Daten, anstatt die Daten von einer Datenebene abzurufen. Für ein vollständiges Funktionierendes Beispiel müssen Sie diese Klassen kompilieren und mit den bereitgestellten Web Forms Codebeispielen verwenden.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Data;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates 
  // the operations you can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList data = new ArrayList();
           
      data.Add(new NorthwindEmployee(1,"Nancy","Davolio","507 - 20th Ave. E. Apt. 2A"));
      data.Add(new NorthwindEmployee(2,"Andrew","Fuller","908 W. Capital Way"));
      data.Add(new NorthwindEmployee(3,"Janet","Leverling","722 Moss Bay Blvd."));
      data.Add(new NorthwindEmployee(4,"Margaret","Peacock","4110 Old Redmond Rd."));
      data.Add(new NorthwindEmployee(5,"Steven","Buchanan","14 Garrett Hill"));
      data.Add(new NorthwindEmployee(6,"Michael","Suyama","Coventry House Miner Rd."));
      data.Add(new NorthwindEmployee(7,"Robert","King","Edgeham Hollow Winchester Way"));
      
      return data;
    }
    
    public static NorthwindEmployee GetEmployee(object anID) {
      ArrayList data = GetAllEmployees() as ArrayList;     
      int empID = Int32.Parse(anID.ToString());      
      return data[empID] as NorthwindEmployee;
    }

    // 
    // To support basic filtering, the employees cannot
    // be returned as an array of objects, rather as a 
    // DataSet of the raw data values. 
    public static DataSet GetAllEmployeesAsDataSet () {
      ICollection employees = GetAllEmployees();
      
      DataSet ds = new DataSet("Table");
      
      // Create the schema of the DataTable.
      DataTable dt = new DataTable();
      DataColumn dc;
      dc = new DataColumn("EmpID",   typeof(int));    dt.Columns.Add(dc);
      dc = new DataColumn("FullName",typeof(string)); dt.Columns.Add(dc);
      dc = new DataColumn("Address", typeof(string)); dt.Columns.Add(dc);
      
      // Add rows to the DataTable.
      DataRow row;
            
      foreach (NorthwindEmployee ne in employees) {                
        row = dt.NewRow();
        row["EmpID"]    = ne.EmpID;
        row["FullName"] = ne.FullName;
        row["Address"]  = ne.Address;
        dt.Rows.Add(row);
      } 
      // Add the complete DataTable to the DataSet.
      ds.Tables.Add(dt);
      
      return ds;
    }    
  }

  public class NorthwindEmployee {

    public NorthwindEmployee (int anID, 
                              string aFirstName,
                              string aLastName,
                              string anAddress) {
      ID = anID;
      firstName = aFirstName;
      lastName = aLastName;   
      address = anAddress;
    }

    private object ID;
    public string EmpID {
      get { return ID.ToString();  }
    }

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }
    
    public string FullName {
      get { return FirstName  + " " +  LastName; }
    }
    
    private string address;
    public string Address {
      get { return address; }
      set { address = value;  }
    }    
  }
}

Hinweise

Beim Erstellen eines ObjectDataSourceFilteringEventHandler-Delegaten geben Sie die Methode für die Ereignisbehandlung an. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.

Gilt für:

Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Weitere Informationen