閱讀英文版本

分享方式：

ObjectDataSourceFilteringEventHandler 代理人

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

表示處理 Filtering 控制項之 ObjectDataSource 事件的方法。

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

參數

sender
Object

事件的來源：ObjectDataSource。

e
ObjectDataSourceFilteringEventArgs

包含事件資料的 ObjectDataSourceFilteringEventArgs。

範例

本節包含兩個程式碼範例。 第一個 ObjectDataSource 程式碼範例示範如何使用 控制項從仲介層商務物件擷取資料，然後使用 GridView 控制項來顯示結果，以顯示篩選過的資料。 第二個程式碼範例提供第一個程式碼範例所使用的仲介層商務物件範例。

下列程式碼範例示範如何使用 控制項從仲介層商務物件擷取資料，然後使用 GridView 控制項來顯示結果，以顯示篩選過的資料 ObjectDataSource 。 ObjectDataSource只有當擷取資料的方法擷取資料做為 DataSet 或 DataTable 物件時，控制項才能篩選資料。 基於這個理由， SelectMethod 屬性會識別擷取資料做為 DataSet 或 DataTable 物件的商務物件方法。

程式碼範例包含 TextBox 控制項、 GridView 控制項、 ObjectDataSource 控制項和 [提交 ] 按鈕。 根據預設， TextBox 控制項會填入 Northwind Traders 中其中一個員工的名稱。 控制項 GridView 會顯示 中名稱 TextBox 所識別之員工的相關資訊。 若要擷取另一位員工的資料，請在 TextBox 控制項中輸入員工的完整名稱，然後按一下 [ 提交 ] 按鈕。

屬性 FilterExpression 會指定運算式，用來篩選 屬性所指定方法所 SelectMethod 擷取的資料。 它會使用評估為集合中 FilterParameters 所含參數的參數預留位置。 在此範例中，參數預留位置會以單引號括住 (') ，因為參數的類型是可能包含空格的字串類型。 如果參數的類型是數值或日期，則不需要引號。 FilterParameters集合包含一個參數，這是 FormParameter 系結至 控制項的 TextBox 物件。

如果控制項中 TextBox 未指定任何名稱，則會將新的參數新增至 ParameterValues 集合，讓搜尋成功。

ASP.NET (C#) 
<%@ 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>

下列程式碼範例提供上述程式碼範例所使用的仲介層商務物件範例。 程式碼範例包含兩個基本類別： EmployeeLogic 和 NorthwindEmployee 。 類別會封裝商務邏輯， NorthwindEmployee 而 類別 EmployeeLogic 是一個模型類別，只包含從資料層載入和保存資料所需的基本功能。 為了簡單起見，類別 EmployeeLogic 會建立靜態資料集，而不是從資料層擷取資料。 如需完整的工作範例，您必須編譯並使用這些類別搭配提供的Web Form程式碼範例。

C# 
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;  }
    }    
  }
}

備註

當您建立 ObjectDataSourceFilteringEventHandler 委派 (Delegate) 時，就可以識別即將處理此事件的方法。 若要使事件與您的事件處理常式產生關聯，請將委派的執行個體 (Instance) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需如何處理事件的詳細資訊，請參閱 處理和引發事件。

擴充方法

GetMethodInfo(Delegate)

取得表示特定委派所代表之方法的物件。

適用於

產品 版本
.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

另請參閱