萬盛學電腦網

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

ASP.NET 細粒度 HTML 元素權限控制實作 (一):掃描、分配、載入與整合

前言

企業級系統常需依角色動態顯示/隱藏頁面元素 (按鈕、欄位、區塊)。本文提出「掃描→分配→載入→整合」四階段架構,實現以 HTML 元素 id 為最小單位的權限控制,支援「一般用戶/管理員/超管」多角色差異化介面。

一、整體架構流程

  1. 掃描階段:啟動時掃描所有 .aspx/.ascx,擷取標記 data-perm 的元素 id、name、tagName,存入資料表 Sys_UIElement。
  2. 分配階段:後台管理介面以樹狀結構呈現元素,配置「角色-元素」權限矩陣 (可見/可編輯/可執行)。
  3. 載入階段:使用者登入後,依角色彙總可見元素清單,存入 Session/Cache (List<string> allowedElementIds)。
  4. 整合階段:頁面 PreRender 階段,遍歷控制項樹,將不在白名單中的元素 Visible=false 或移除。

二、資料庫設計

-- UI 元素主檔
CREATE TABLE Sys_UIElement (
    ElementId   INT IDENTITY PRIMARY KEY,
    PagePath    VARCHAR(200) NOT NULL,   -- 如 /Admin/UserList.aspx
    ElementId   VARCHAR(100) NOT NULL,   -- HTML id (btnAdd, gvUsers_colDelete)
    ElementName VARCHAR(100),            -- 顯示名稱
    TagName     VARCHAR(20),             -- button, a, td, tr, div...
    ParentId    INT NULL,                -- 階層關係
    IsActive    BIT DEFAULT 1,
    UNIQUE(PagePath, ElementId)
);

-- 角色-元素權限
CREATE TABLE Sys_RoleElementPerm (
    RoleId      INT NOT NULL,
    ElementId   INT NOT NULL,
    PermLevel   TINYINT NOT NULL, -- 0=隱藏 1=唯讀 2=可編輯 3=可執行
    PRIMARY KEY (RoleId, ElementId)
);

三、掃描器實作 (啟動時/部署後執行一次)

public class UIPermissionScanner
{
    public void ScanAndSync(string webRootPath)
    {
        var files = Directory.GetFiles(webRootPath, "*.aspx", SearchOption.AllDirectories)
                       .Concat(Directory.GetFiles(webRootPath, "*.ascx", SearchOption.AllDirectories));

        using (var db = new AppDbContext())
        {
            foreach (var file in files)
            {
                string html = File.ReadAllText(file, Encoding.UTF8);
                var doc = new HtmlAgilityPack.HtmlDocument();
                doc.LoadHtml(html);

                var nodes = doc.DocumentNode.SelectNodes("//*[@data-perm]");
                if (nodes == null) continue;

                string pagePath = file.Replace(webRootPath, "").Replace("\\", "/");

                foreach (var node in nodes)
                {
                    string elId = node.GetAttributeValue("id", null);
                    if (string.IsNullOrEmpty(elId)) continue; // 必須有 id

                    var entity = db.UIElements.FirstOrDefault(x => x.PagePath == pagePath && x.ElementId == elId);
                    if (entity == null)
                    {
                        entity = new Sys_UIElement
                        {
                            PagePath = pagePath,
                            ElementId = elId,
                            ElementName = node.GetAttributeValue("data-perm-name", elId),
                            TagName = node.Name,
                            IsActive = true
                        };
                        db.UIElements.Add(entity);
                    }
                }
            }
            db.SaveChanges();
        }
    }
}

頁面標記範例:<asp:Button ID="btnDelete" runat="server" data-perm="true" data-perm-name="刪除用戶" />

四、登入時載入權限集合

public class PermissionService
{
    public HashSet<string> GetAllowedElementIds(int userId)
    {
        // 取得使用者角色
        var roleIds = db.UserRoles.Where(ur => ur.UserId == userId).Select(ur => ur.RoleId).ToList();

        // 彙總權限等級 >= 1 (可見) 的元素
        var elementKeys = db.RoleElementPerms
            .Where(p => roleIds.Contains(p.RoleId) && p.PermLevel >= 1)
            .Join(db.UIElements, p => p.ElementId, e => e.ElementId, (p, e) => e.PagePath + "|" + e.ElementId)
            .ToList();

        return new HashSet<string>(elementKeys, StringComparer.OrdinalIgnoreCase);
    }
}

// Global.asax 或 Login 後
protected void Session_Start(object sender, EventArgs e)
{
    if (Context.User.Identity.IsAuthenticated)
    {
        var svc = new PermissionService();
        Session["AllowedElements"] = svc.GetAllowedElementIds(GetCurrentUserId());
    }
}

五、頁面基類整合:PreRender 階段自動隱藏

public class SecurePage : System.Web.UI.Page
{
    protected override void OnPreRender(EventArgs e)
    {
        base.OnPreRender(e);
        ApplyElementPermissions();
    }

    private void ApplyElementPermissions()
    {
        var allowed = Session["AllowedElements"] as HashSet<string>;
        if (allowed == null) return; // 未登入或無權限資料

        string pageKey = Request.AppRelativeCurrentExecutionFilePath.Replace("~", "").ToLowerInvariant();

        // 遞迴遍歷控制項樹
        ProcessControlTree(this.Controls, pageKey, allowed);
    }

    private void ProcessControlTree(ControlCollection controls, string pageKey, HashSet<string> allowed)
    {
        foreach (Control ctrl in controls)
        {
            // 組合鍵值:頁面|控制項ID
            string key = pageKey + "|" + ctrl.ID;
            if (!string.IsNullOrEmpty(ctrl.ID) && !allowed.Contains(key))
            {
                ctrl.Visible = false; // 或移除:ctrl.Parent.Controls.Remove(ctrl);
                continue; // 子控制項隨父隱藏,無需再遞迴
            }

            if (ctrl.HasControls())
                ProcessControlTree(ctrl.Controls, pageKey, allowed);
        }
    }
}

所有頁面繼承 SecurePage 即可自動套用權限,無需在每頁撰寫判斷邏輯。

六、進階:支援「唯讀/可編輯」狀態

擴充 PermLevel:

  • 0 = 隱藏 (Visible=false)
  • 1 = 唯讀 (TextBox → ReadOnly=true、Button → Enabled=false、GridView 停用編輯列)
  • 2 = 可編輯 (正常)

在 ProcessControlTree 中依 PermLevel 切換屬性,需額外快取 Dictionary<string, byte> elementPermLevel。

七、效能優化建議

  • 權限集合存入 HttpRuntime.Cache (Key: Perm_{RoleId}),登入時直接從 Cache 取用,減少 DB 查詢。
  • 掃描器改為建置時期任務 (MSBuild Target / CI Pipeline),避免啟動掃描影響啟動速度。
  • 使用 ControlAdapter 或 PageParserFilter 在編譯期移除無權限控制項,徹底消除 ViewState 體積與生命週期開銷。
copyright © 萬盛學電腦網 all rights reserved