WinFormPermission 1.0.0

WinFormPermission

WinForm 通用权限管理模块（.NET Framework 4.5）

项目介绍

这是一个轻量级 WinForm 权限管理模块，支持：

• 特性/动态两种方式给控件/菜单设置权限（隐藏/禁用）
• 账号密码PBKDF2加密存储，配置文件持久化
• 登录验证 + 多权限密码修改
• 权限变更后所有窗体动态刷新
• 完美适配Button、菜单、工具栏等常用WinForm控件

QuickStart —— WinFormPermission 快速集成

一、项目引用

1. 将 WinFormPermission 项目添加到你的解决方案
2. 你的主项目 → 引用 → 项目引用 → 勾选 WinFormPermission

二、快速使用步骤

1. 窗体继承权限基类

把你的窗体继承自 PermissionBaseForm

using WinFormPermission;

public partial class MainForm : PermissionBaseForm
{
    public MainForm()
    {
        InitializeComponent();
    }
}

2. 给控件设置权限

方式 1：特性标记「PermissionControl」

用法步骤 窗体继承PermissionBaseForm（自动加载权限规则） 给控件私有字段加[PermissionControl]特性（必须标记字段，不能标记控件实例）

public partial class MainForm : PermissionBaseForm
{
    // 2. 给控件字段加特性，自动生效
    [PermissionControl(UserPermission.Supervisor)] // 主管及以上可见（默认隐藏）
    private Button btnSupervisor;

    [PermissionControl(UserPermission.Admin, ControlState.Disabled)] // 仅管理员可用，低权限禁用
    private TextBox txtAdminInfo;

    [PermissionControl(UserPermission.Operator)] // 操机员及以上可见
    private ToolStripMenuItem tsmiOperator;

    public MainForm()
    {
        InitializeComponent();
    }
}

方式 2：动态调用「SetControlPermission」方法（灵活，运行时可改）

// 普通按钮：主管及以上可见
btnSupervisor.SetControlPermission(UserPermission.Supervisor);
// 文本框：仅管理员可用，低权限禁用
txtAdminInfo.SetControlPermission(UserPermission.Admin, ControlState.Disabled);
// 菜单控件：操机员及以上可见
tsmiOperator.SetControlPermission(UserPermission.Operator);
// 工具栏按钮：管理员及以上可见
tsbAdmin.SetControlPermission(UserPermission.Admin);

3. 启动登录窗口

程序入口调用登录：

static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);

    // 直接设置权限
	GlobalPermissionService.Instance.PermissionService.SetCurrentPermission(UserPermission.Employee);
	Application.Run(new MainForm());

    //// 调用登录
    //if (LoginDialog.ShowLogin() == DialogResult.OK)
    //{
    //    Application.Run(new MainForm());
    //}
}

三、默认账号密码

普通员工（Employee）：123 操机员（Operator）：666 主管（Supervisor）：999 管理员（Admin）：ccf

四、权限说明

权限等级（从低到高）： Employee < Operator < Supervisor < Admin 高等级权限自动拥有低等级的所有权限。

适用场景

• WinForm 项目快速集成权限管理
• 自用项目复用权限模块
• 小型系统快速开发

运行环境

• .NET Framework 4.5
• Visual Studio 2019 及以上
• 依赖Newtonsoft.Json（NuGet直接安装）

快速使用

1. 克隆项目直接编译
2. 参考 QuickStart.md 快速集成到自己的项目
3. 运行 Demo 查看权限效果

开源协议

MIT License