ASP.NET - 使用数据源控件对数据进行排序

 

      通过使用数据源控件和数据绑定控件，可以在 ASP.NET 网页中显示数据。有些数据控件还允许用户对数据进行排序，而不用编写任何代码。

      如果要使用户能够在运行时对数据排序，可以使用 LinqDataSource、ObjectDataSource、SqlDataSource 或 AccessDataSource 控件作为数据源控件。若要显示可由用户排序的数据，可以使用 GridView 控件或 ListView 控件。

 

一、提供用于排序的用户界面

您可以创建任何用于排序的用户界面 (UI)。但是，GridView 和 ListView 控件提供了默认的用户界面排序。

GridView 控件支持在不需要任何编程的情况下通过单个列排序。通过将 AllowSorting 属性设置为 true，可自动将每个列的标题文本创建为向数据源控件传递排序表达式的链接按钮。而通过处理排序事件，还可以进一步自定义 GridView 控件的排序功能。

通过在 ListView 控件的 LayoutTemplate 模板中添加一个按钮，并将该按钮的 CommandName 属性设置为“Sort”，可以对该控件中显示的数据排序。该按钮的 CommandArgument 属性应设置为要用作排序依据的列名。单击“Sort”（排序）按钮可在排序方向 Ascending 和 Descending 之间切换。

 

二、在数据源控件中启用排序

2.1、对排序提供内置支持的数据源控件是 LinqDataSource、ObjectDataSource、SqlDataSource 和 AccessDataSource 控件。在将 AutoSort 属性设置为 true（默认值）时，LinqDataSource 控件会支持排序，如下面的示例所示：

<asp:LinqDataSource

    ContextTypeName="ExampleDataContext"

    TableName="Products"

    AutoPage="true"

    AutoSort="true"

    ID="LinqDataSource1"

    runat="server">

</asp:LinqDataSource>

<asp:GridView

    AllowPaging="true"

    AllowSorting="true"

    DataSourceID="LinqDataSource1"

    ID="GridView1"

    runat="server">

</asp:GridView>

 

2.2 SqlDataSource 和 AccessDataSource 控件只有在其 DataSourceMode 属性设置为 DataSet（默认）时才支持排序，如下面的示例所示：

<asp:GridView ID="EmployeesGridView"

  DataSourceID="EmployeesSqlDataSource"

  DataKeyNames="EmployeeID"

  AllowSorting="True"

  RunAt="Server" />

 

<asp:SqlDataSource ID="EmployeesSqlDataSource" 

  SelectCommand="SELECT EmployeeID, LastName, FirstName FROM Employees"

  Connectionstring="<%$ ConnectionStrings:NorthwindConnectionString %>"

  RunAt="server" />

      如果 SelectMethod 返回的对象是 DataSet、DataTable 或 DataView 对象，则 ObjectDataSource 控件支持排序。ObjectDataSource 还支持按排序后的顺序对数据源中的结果进行检索。

 

三、自定义排序

您可以自定义数据绑定控件和数据源控件执行排序的方式。这样，将可以修改自动排序的执行方式，也可以创建自定义排序例程。

使用 LinqDataSource 控件时，可通过将 AutoSort 属性设置为 false 自定义排序。随后可以为 Selecting 事件创建处理程序。

使用 ObjectDataSource 或 SqlDataSource 控件时，可通过 SortParameterName 属性来利用各种排序功能。可以将 SortParameterName 属性设置为包含传递到数据源控件的排序表达式的参数名称。排序表达式是作为排序依据的字段的列表，这些字段间以逗号分隔（还可以选择 DESC 标识符按降序排列）。

由 SortParameterName 属性标识的参数被传递给 ObjectDataSource 控件的 SelectMethod 或作为参数集合的一部分传递给 SqlDataSource 控件的 SelectCommand。ObjectDataSource 控件可以使用在排序参数中传递给它的信息，从而按排序后的顺序返回数据。对于 SqlDataSource 控件，由于不能将参数作为 ORDER BY 子句的一部分进行传递，因此必须提供可获取排序参数并返回已排序数据的存储过程的名称。

<asp:ObjectDataSource

  ID="EmployeesObjectDataSource"

  runat="server"

  TypeName="Samples.AspNet.Controls.NorthwindEmployee"

  SortParameterName="SortColumns"

  EnablePaging="true"

  StartRowIndexParameterName="StartRecord"

  MaximumRowsParameterName="MaxRecords"

  SelectMethod="GetAllEmployees" >

</asp:ObjectDataSource>

 

      下面的代码示例演示 ObjectDataSource 控件源对象中的一个方法。该方法被标识为 SelectMethod。由 SortParameterName 属性标识的参数用于对从数据库中检索的数据进行排序。

public static void Initialize()

{

  // Initialize data source. Use "Northwind" connection string from configuration.

 

  if (ConfigurationManager.ConnectionStrings["Northwind"] == null ||

      ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString.Trim() == "")

  {

    throw new Exception("A connection string named 'Northwind' with a valid connection string " +

                        "must exist in the <connectionStrings> configuration section for the application.");

  }

 

  _connectionString =

    ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString;

 

  _initialized = true;

}

 

 

// Select all employees.

 

[DataObjectMethod(DataObjectMethodType.Select, true)]

public static DataTable GetAllEmployees(string sortColumns, int startRecord, int maxRecords)

{

  VerifySortColumns(sortColumns);

 

  if (!_initialized) { Initialize(); }

 

  string sqlCommand = "SELECT EmployeeID, LastName, FirstName, Address, City, Region, PostalCode FROM Employees ";

 

  if (sortColumns.Trim() == "")

    sqlCommand += "ORDER BY EmployeeID";

  else

    sqlCommand += "ORDER BY " + sortColumns;

 

  SqlConnection conn = new SqlConnection(_connectionString);

  SqlDataAdapter da  = new SqlDataAdapter(sqlCommand, conn);

 

  DataSet ds =  new DataSet();

 

  try

  {

    conn.Open();

    da.Fill(ds, startRecord, maxRecords, "Employees");

  }

  catch (SqlException e)

  {

    // Handle exception.

  }

  finally

  {

    conn.Close();

  }

 

  if (ds.Tables["Employees"] != null)

    return ds.Tables["Employees"];

 

  return null;

}

 

 

//

// Verify that only valid columns are specified in the sort expression to avoid a SQL Injection attack.

 

private static void VerifySortColumns(string sortColumns)

{

  if (sortColumns.ToLowerInvariant().EndsWith(" desc"))

    sortColumns = sortColumns.Substring(0, sortColumns.Length - 5);

 

  string[] columnNames = sortColumns.Split(',');

 

  foreach (string columnName in columnNames)

  {

    switch (columnName.Trim().ToLowerInvariant())

    {

      case "employeeid":

        break;

      case "lastname":

        break;

      case "firstname":

        break;

      case "":

        break;

      default:

        throw new ArgumentException("SortColumns contains an invalid column name.");

        break;

    }

  }

}