企業級系統常需依角色動態顯示/隱藏頁面元素 (按鈕、欄位、區塊)。本文提出「掃描→分配→載入→整合」四階段架構,實現以 HTML 元素 id 為最小單位的權限控制,支援「一般用戶/管理員/超管」多角色差異化介面。
data-perm 的元素 id、name、tagName,存入資料表 Sys_UIElement。List<string> allowedElementIds)。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());
}
}
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:
Visible=false)ReadOnly=true、Button → Enabled=false、GridView 停用編輯列)在 ProcessControlTree 中依 PermLevel 切換屬性,需額外快取 Dictionary<string, byte> elementPermLevel。
HttpRuntime.Cache (Key: Perm_{RoleId}),登入時直接從 Cache 取用,減少 DB 查詢。ControlAdapter 或 PageParserFilter 在編譯期移除無權限控制項,徹底消除 ViewState 體積與生命週期開銷。