[.NET] SQL数据分页查询

程序下载

范例下载：点此下载

原始码下载：点此下载

NuGet封装：点此下载

数据查询

开发系统时，使用C#执行SQL查询指令，就可以从SQL数据库里查询所需数据。

SELECT Id, Name FROM Users

数据分页查询

当数据量过多时，系统会需要采用分页的方式来分批取得数据。这时可以改写原有的SQL查询指令，在其中加入ROW_NUMBER()，来为每笔资料打上编号。后续依照系统需求，取得某个编号范围内的数据，就完成在系统中提供数据分页查询的功能。(MS SQL 2012之后的SQL版本，改用OFFSET - FETCH会更简洁。)

SELECT * 
FROM   (
            SELECT ROW_NUMBER() OVER(ORDER BY Id ASC) __RowNumber, 
                    Id, Name 
            FROM   Users
        ) __RowNumberTable
WHERE  __RowNumberTable.__RowNumber BETWEEN @__StartRowNumber AND @__EndRowNumber

提取为共享方法

上述这个改写SQL查询指令的动作，是很机械化的固定动作，透过抽取其中的动作流程，可以建立一个共享方法：GetLimitText方法。透过这个GetLimitText方法，开发人员传入查询的SQL查询指令，GetLimitText方法就会改写这个SQL查询指令，回传一个提供数据分页查询的SQL分页查询指令。开发人员使用C#来执行这个SQL分页查询指令，就能在系统中提供数据分页查询的功能。

using (SqlCommand command = new SqlCommand())
{
    // Connection
    command.Connection = connection;

    // CommandParameters
    command.Parameters.Add(new SqlParameter("@__StartRowNumber", index + 1));
    command.Parameters.Add(new SqlParameter("@__EndRowNumber", index + count));

    // CommandText
    command.CommandText = @"SELECT Id, Name FROM Users";

    // LimitText
    command.CommandText = SqlCommandExtensions.GetLimitText(command.CommandText, "Id ASC");

    // Create
    using (SqlDataReader reader = command.ExecuteReader())
    {
        dataTable.Load(reader);
    }
}

public static string GetLimitText(string commandText, string orderbyText)
{
    #region Contracts

    if (string.IsNullOrEmpty(commandText) == true) throw new ArgumentNullException();
    if (string.IsNullOrEmpty(orderbyText) == true) throw new ArgumentNullException();

    #endregion

    // Remove "SELECT"
    commandText = commandText.Trim().Remove(0, 6);

    // LimitText
    var limitText = @"SELECT * 
                        FROM   (
                                SELECT ROW_NUMBER() OVER(ORDER BY {0}) __RowNumber, {1}
                                ) __RowNumberTable
                        WHERE  __RowNumberTable.__RowNumber BETWEEN @__StartRowNumber AND @__EndRowNumber";

    limitText = string.Format(limitText, orderbyText, commandText);

    // Return
    return limitText;
}

封装为扩充方法

为了更方便开发人员使用GetLimitText方法，可以将这个方法近一步封装成为SqlCommand类别的扩充方法：ExecuteReader方法，让数据分页查询功能伪装成为SqlCommand类别的方法。后续开发人员只要建立SQL查询指令，并且执行ExecuteReader方法，就能够很快速的在系统中提供数据分页查询的功能。

using (SqlCommand command = new SqlCommand())
{
    // Connection
    command.Connection = connection;

    // CommandText
    command.CommandText = @"SELECT Id, Name FROM Users";

    // Create
    using (SqlDataReader reader = command.ExecuteReader(index, count, "Id ASC"))
    {
        dataTable.Load(reader);
    }
}

public static SqlDataReader ExecuteReader(this SqlCommand command, int index, int count, string orderbyText)
{
    #region Contracts

    if (command == null) throw new ArgumentNullException();
    if (string.IsNullOrEmpty(orderbyText) == true) throw new ArgumentNullException();

    #endregion

    // CommandParameters
    command.Parameters.Add(new SqlParameter("@__StartRowNumber", index + 1));
    command.Parameters.Add(new SqlParameter("@__EndRowNumber", index + count));

    // LimitText
    var limitText = GetLimitText(command.CommandText, orderbyText);

    // ExecuteReader
    var commandText = command.CommandText;
    try
    {
        // Set
        command.CommandText = limitText;

        // Execute
        return command.ExecuteReader();
    }
    finally
    {
        // Reset
        command.CommandText = commandText;
    }
}