萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 分頁控制項 PageString:支援 AJAX、自訂文字、樣式客製化

輕量級分頁元件:零相依、可嵌入 Web Forms/MVC、支援非同步

自製 `PageString` 類別產生分頁 HTML,支援同步連結 (href) 與 AJAX 回呼 (onclick),文字、樣式、參數名全可配置。

使用方式

var ps = new PageString();
ps.SetIsEnglish = false;           // 中文介面
ps.SetIsShowText = true;           // 顯示「共 N 條,第 M/P 頁」
ps.SetTextFormat = "總共:{0} 條 當前:{1}/{2}";
ps.SetClassName = "pagination";    // CSS 類別
ps.SetPageIndexName = "pageIndex"; // QueryString 參數名
ps.SetIsAjax = false;              // true=onclick='ajaxPage()', false=href

int total = 10000;
int pageSize = 10;
int pageIndex = Convert.ToInt32(Request["pageIndex"] ?? "1");

string html = ps.ToString(total, pageSize, pageIndex, "/UI/List.aspx?");
Response.Write(html);

PageString 核心實作

using System;
using System.Text;
using System.Text.RegularExpressions;

public class PageString
{
    public bool SetIsEnglish { get; set; } = false;
    public bool SetIsShowText { get; set; } = true;
    public string SetClassName { get; set; } = "pagination";
    public string SetPageIndexName { get; set; } = "pageIndex";
    public bool SetIsAjax { get; set; } = false;
    public string SetTextFormat { get; set; } = 
        "總共:{0} 條 當前:{1}/{2}";

    public PageString() { }

    public string ToString(int totalCount, int pageSize, int pageIndex, string baseUrl)
    {
        if (totalCount <= 0) return "";
        if (pageSize <= 0) pageSize = 10;
        if (pageIndex < 1) pageIndex = 1;

        int totalPages = (int)Math.Ceiling((double)totalCount / pageSize);
        if (totalPages <= 1) return "";

        var sb = new StringBuilder();
        string sep = baseUrl.Contains("?") ? "&" : "?";
        string pageParam = SetPageIndexName + "=";

        // 文字資訊
        if (SetIsShowText)
        {
            string text = String.Format(SetTextFormat, totalCount, pageIndex, totalPages);
            sb.Append(text);
        }

        sb.Append($"
"); // 首頁/上一頁 if (pageIndex > 1) { sb.Append(Link(1, SetIsEnglish ? "First" : "首頁", baseUrl, sep, pageParam)); sb.Append(Link(pageIndex - 1, SetIsEnglish ? "Prev" : "上一頁", baseUrl, sep, pageParam)); } else { sb.Append(Span(SetIsEnglish ? "First" : "首頁", "current prev")); sb.Append(Span(SetIsEnglish ? "Prev" : "上一頁", "current prev")); } // 頁碼範圍:顯示當前頁前後各 2 頁 int start = Math.Max(1, pageIndex - 2); int end = Math.Min(totalPages, pageIndex + 2); if (start > 1) sb.Append(Span("...", "ellipsis")); for (int i = start; i <= end; i++) { if (i == pageIndex) sb.Append(Span(i.ToString(), "page_current")); else sb.Append(Link(i, i.ToString(), baseUrl, sep, pageParam)); } if (end < totalPages) sb.Append(Span("...", "ellipsis")); // 下一頁/末頁 if (pageIndex < totalPages) { sb.Append(Link(pageIndex + 1, SetIsEnglish ? "Next" : "下一頁", baseUrl, sep, pageParam)); sb.Append(Link(totalPages, SetIsEnglish ? "Last" : "末頁", baseUrl, sep, pageParam)); } else { sb.Append(Span(SetIsEnglish ? "Next" : "下一頁", "current next")); sb.Append(Span(SetIsEnglish ? "Last" : "末頁", "current next")); } sb.Append("
"); return sb.ToString(); } private string Link(int page, string text, string baseUrl, string sep, string pageParam) { string url = $"{baseUrl}{sep}{pageParam}{page}"; return SetIsAjax ? $"{text}" : $"{text}"; } private string Span(string text, string cssClass) => $"{text}"; }

建議 CSS (免費樣式)

.pagination {margin-top:20px; font-size:13px;}
.pagination a {text-decoration:none; border:1px solid #AAE; color:#15B; border-radius:2px; 
    display:inline-block; padding:0.2em 0.6em; margin-right:5px;}
.pagination a:hover {background:#26B; color:#fff;}
.pagination span {display:inline-block; border:1px solid #ccc; padding:0.2em 0.6em; margin-right:5px; color:#666;}
.pagination .page_current {background:#26B; color:#fff; border:1px solid #AAE;}
.pagination .current.prev, .pagination .current.next {color:#999; border-color:#999; background:#fff;}
.pagination .ellipsis {border:none; color:#999;}
.pagination .pagetext {border:none; margin-right:10px;}

AJAX 整合範例

// SetIsAjax = true 時產生 onclick="ajaxPage(n)"
function ajaxPage(pageIndex) {
    $.get("/UI/List.aspx", { pageIndex: pageIndex }, function(html) {
        $("#content").html(html);  // 區域更新
    });
}

進階擴充:Bootstrap 4/5 樣式

// 修改 Link/Span 產生 
  • ...
  • // SetClassName = "pagination justify-content-center" // 配合
      包裹

    效能提示: 大資料集 (百萬筆+) 請改用 **Keyset Pagination** (WHERE id > @lastId ORDER BY id LIMIT @pageSize),避免 `OFFSET` 深分頁效能崩潰。

    copyright © 萬盛學電腦網 all rights reserved