简介一套C#基于WPF的企业OA系统源码适合.NET桌面开发者、学习者及需要搭建办公自动化系统的团队参考采用C/S模式在Windows环境下运行。系统基于Visual Studio 2012与SQL Server 2008R2构建业务涵盖审批、计划、日程、考勤、劳资、人事客户及内置记事本等17个模块其中审批中心支持人事、项目、公文三类申请及流程审核计划中心面向经理制定销售与业绩计划考勤管理实现签到和出勤统计劳资管理支持工资核算整体覆盖企业常用办公流程。整个压缩包为zip格式共582个文件大小约17.3MB主体包括253个C#源码文件、38个XAML界面布局、74个BAML编译资源及48个PNG图标另有DLL动态库、MDF/LDF数据库文件、config配置和解决方案文件便于在Visual Studio中查看与编译。目前已有790人学习下载通过这份源码可以了解WPF界面布局、数据绑定、模块化设计以及SQL Server数据库交互可作为毕业设计、课程项目或企业二次开发的实用示例。1. C#企业OA的客户端路线为什么这套源码坚持用WPF写收到“C#基于WPF的企业OA系统源码”这个标题时很多人的第一反应是都什么年代了办公系统还用桌面客户端实际在企业内网里WPF并没有退场反而在一些行业里活得很好。制造、物流、医疗这类场景要求数据不出域终端要挂扫码枪、读卡器、USB加密狗浏览器里的权限模型和硬件访问能力根本罩不住加上审批流、待办提醒这类高频交互桌面端的响应速度和离线能力仍然是实打实的优势。这篇文章按一套常见的企业OA源码为线索讲清楚它为什么这样分层、模块怎么拆、怎么在本地跑通以及最容易让新手翻车的地方。适合想上手WPF实战项目、或者准备接手维护这类老系统的开发者。2. 选型背后的两个支点WPF绑定机制和MVVM怎么扛住OA复杂度企业OA系统的特征是界面多、表单密、状态变来变去。今天加一个字段明天调一个审批状态后天换一套公司Logo配色。如果界面逻辑全靠手工赋值刷新维护成本会指数级上升。WPF能成为这类客户端的主流选择靠的是两个机制数据绑定和数据模板以及围绕它们建立的MVVM架构。这一章把这两件事讲透你就知道为什么源码里到处都是Binding和ICommand而不是像老WinForms那样到处是textBox1.Text ...。2.1 绑定机制从 INotifyPropertyChanged 到 DataTemplateWPF绑定的核心思想是界面不主动拉数据而是订阅数据的变化。但绑定不是开箱即用的——属性必须是DependencyProperty或者所在类实现了INotifyPropertyChanged。企业OA里最常见的是后一种因为ViewModel是普通C#类不依赖UI框架。一段典型的属性封装长这样public class NotifyObject : INotifyPropertyChanged { public event PropertyChangedEventHandler? PropertyChanged; protected void SetT(ref T field, T value, [CallerMemberName] string? propName null) { if (!EqualityComparerT.Default.Equals(field, value)) { field value; PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propName)); } } } public class MainWindowViewModel : NotifyObject { private int _pendingCount; public int PendingCount { get _pendingCount; set Set(ref _pendingCount, value); } }逻辑说明Set方法先用EqualityComparerT比较新旧值值没变就不触发事件避免界面无意义刷新[CallerMemberName]让调用处不用手动传属性名PendingCount 5时自动带上PendingCount字符串。这是一个被大量项目复用的小基类接手源码时如果看到NotifyObject、ViewModelBase之类的父类多半就是这个套路。有了属性通知接下来要解决的是“一堆审批卡片怎么显示”。新手容易在Code-behind里用循环拼控件然后越写越长。WPF的做法是给数据定一个DataTemplate让控件自动按类型渲染DataTemplate DataType{x:Type models:ApprovalItem} Border Margin4 Padding8 BorderBrush#DDD BorderThickness1 CornerRadius4 StackPanel TextBlock Text{Binding Title} FontWeightBold / TextBlock Text{Binding ApplyTime, StringFormatyyyy-MM-dd HH:mm} ForegroundGray / /StackPanel /Border /DataTemplate逻辑说明DataType让WPF在遇到ApprovalItem对象时自动套用这个模板不需要给每个ListBoxItem手写样式StringFormat直接在绑定里格式化时间省掉ViewModel里写ToString的脏代码。OA系统里公告列表、待办列表、审批历史本质上都是“一个对象集合 一个模板”的组合这就是WPF处理这类需求比WinForms省力的根本原因。2.2 MVVM 的角色分配与 ICommand 实践MVVM不是WPF强制要求但做企业OA这种中型项目不用MVVM基本会失控。Model只装数据和业务规则View只做显示ViewModel是两者之间的翻译层。按钮不能直接写成Click事件——Click事件里塞数据库操作测试没法做逻辑也耦合在界面里。源码里通常自带一个RelayCommand把“用户点了按钮”变成“执行一个命令对象”public class RelayCommand : ICommand { private readonly Actionobject? _execute; private readonly Funcobject?, bool? _canExecute; public RelayCommand(Actionobject? execute, Funcobject?, bool? canExecute null) { _execute execute; _canExecute canExecute; } public bool CanExecute(object? parameter) _canExecute?.Invoke(parameter) ?? true; public void Execute(object? parameter) _execute(parameter); public event EventHandler? CanExecuteChanged { add CommandManager.RequerySuggested value; remove CommandManager.RequerySuggested - value; } }参数说明构造函数的第二个参数canExecute是可选的用于控制按钮禁用状态CommandManager.RequerySuggested让WPF在界面交互后自动重新问一次CanExecute比如“只有选中一条待办时通过按钮才可点”。XAML里的用法是Button Content通过 Command{Binding ApproveCommand} CommandParameter{Binding SelectedItem, ElementNameApprovalGrid} /逻辑说明CommandParameter把DataGrid选中的行对象传给ViewModelCommand内部拿到参数后强转成审批实体再走流程。整个链路里ViewModel不关心按钮在哪、长什么样只关心“执行什么动作”这为后面的单元测试和界面换肤都留了空间。还有一点值得说ViewModel里不要直接new SqlConnection。常见做法是给数据访问类写接口用构造函数注入给ViewModel。企业OA里“当前登录人”“当前角色”贯穿所有业务直接new一个连接会导致测试时无法替换数据源也让权限校验逻辑散落在各处。老源码如果没做依赖注入退一步也要保证连接串统一从配置文件读取而不是散落在几十个窗口里。3. 拆源码的三层骨架模块、数据访问、会话状态拿到一套WPF OA源码先不要急着编译。先看工程结构和模块划分等于先读地图再上路。这一章按常见源码的组织方式把“哪些窗口、哪些服务、数据怎么存取、登录状态怎么流转”拆开讲。看懂这三层后续改功能、加模块才不会迷路。3.1 十个功能域与模块划分一套完整的企业OA功能域往往长这样。表格里列的是核心模块和它们的宿主窗口模块宿主窗口/区域核心职责登录认证LoginWindow账号密码校验、验证码、会话初始化主框架MainWindow导航菜单、待办角标、用户信息用户管理UserWindow用户增删改查、启停用、重置密码角色权限RoleWindow角色维护、菜单授权、按钮级权限审批流ApprovalWindow提单、审批、抄送、撤回、流转记录公告通知NoticeWindow发布、置顶、已读状态待办中心TodoWindow聚合各模块待办统一入口日程会议CalendarWindow个人日程、会议预约、冲突检测系统设置SettingWindow数据字典、参数配置、备份恢复日志审计LogWindow登录日志、操作日志、导出模块划分的道理很直接OA的复杂度不在单个页面而在页面之间的数据流转。比如“待办中心”要聚合审批、公告、日程三类数据如果各模块的Repository没有清晰边界待办中心就得到处拼SQL越改越乱。源码里常见做法是每个模块独立成文件夹或独立成工程模块间只通过领域服务通信不直接互相操作对方的DataGrid。工程结构上很多成熟的WPF OA源码会分四个项目Oa.App启动与主窗口、Oa.Views窗口和控件、Oa.ViewModels绑定逻辑、Oa.Models实体和数据库映射。再往上加一个Oa.Infrastructure放通用工具、日志、Session就是很完整的骨架了。3.2 Repository 与 Dapper数据访问层的轻量写法企业OA的SQL不算复杂大量是单表CRUD、联表查询、分页列表。源码里用EF Core的有但更多老项目用的是Dapper——轻量、SQL在手、性能好也容易让新手看懂数据是怎么查出来的。Repository模式是这里最常见的封装方式一个实体对应一个仓储类所有SQL都收拢在一个文件里public class UserRepository { private readonly string _connString; public UserRepository(string connString) { _connString connString; } public async TaskListUser SearchAsync(string keyword, int pageIndex, int pageSize) { const string sql SELECT Id, UserName, RealName, Enabled, LastLoginTime FROM Sys_User WHERE (keyword OR UserName LIKE like OR RealName LIKE like) ORDER BY Id OFFSET offset ROWS FETCH NEXT pageSize ROWS ONLY;; await using var conn new SqlConnection(_connString); var rows await conn.QueryAsyncUser(sql, new { keyword, like $%{keyword}%, offset (pageIndex - 1) * pageSize, pageSize }); return rows.AsList(); } }逻辑说明keyword和like拆成两个参数是关键细节——LIKE语法需要%keyword%但拼接字符串绝不能直接塞进SQL否则就是注入漏洞这里把%{keyword}%作为参数值传进去Dapper会把它当普通字符串处理。OFFSET ... FETCH NEXT是SQL Server 2012以后的分页写法比ROW_NUMBER()更直白。QueryAsyncUser执行完要转成List是为了尽早释放连接避免在UI层还挂着数据库连接。参数说明pageSize一般取20或50OA列表页很少需要超过100条keyword传空字符串时keyword 条件让查询退化为全表分页这是最常见的默认行为。有些源码还会额外统计COUNT(*)返回总条数给分页控件用你会在Repository里看到两个方法成对出现一个查列表、一个查总数。3.3 登录态与全局会话怎么管理OA所有页面都依赖“当前用户是谁”。登录后用户信息放哪直接决定后续代码好不好写。常见做法有两种全局静态类和依赖注入单例。老源码里静态类占多数因为它最容易被各处直接调用不用改构造函数public static class AppSession { public static User CurrentUser { get; private set; } null!; public static int UserId { get; private set; } public static string CurrentUserName CurrentUser?.RealName ?? 未登录; public static void Login(User user) { CurrentUser user; UserId user.Id; } public static void Logout() { CurrentUser null!; UserId 0; } }逻辑说明登录成功后把完整的User对象放进去而不是只存一个Id——OA界面每个角落都要显示“当前操作人”菜单栏、审批记录、操作日志到处要姓名只存Id会让每个页面都多查一次数据库。Logout把所有字段清掉避免会话残留。登录窗口的典型流程是用户输账号密码ViewModel调LoginService做校验成功后把返回的User传给AppSession.Login()然后打开MainWindow关闭LoginWindow。源码里你还会看到登录后往Properties.Settings里写“记住用户名”这个常见但要注意存的是用户名不是密码密码保持Hash在数据库里比对。主窗口的关闭就等于退出系统一般不需要显式调Logout但如果是“切换账号”功能必须先把Session清空再弹登录窗否则新登录用户的权限可能还是上一个用户的缓存数据——这是OA系统里最容易被人忽略的状态残留问题。4. 本地跑通最小闭环编译、初始化数据库、登录验证源码拿到手第一目标不是看懂全部代码而是让它先跑起来。这一章的思路按“环境准备 → 数据库初始化 → 改配置 → 编译启动 → 登录验证”的顺序走。每一步都是踩过的坑照着做能少折腾半天。4.1 环境准备SDK、数据库与还原先打开解决方案里的.csproj文件看一眼TargetFramework。老一点的源码是net48新一点的是net6.0-windows或net8.0-windows。不要盲目装最新版.NETnet48必须装.NET Framework 4.8 Developer Packnet6.0以上才用dotnet SDK。在命令行里先确认环境dotnet --version dotnet build OA.sln如果报NETSDK1004或“找不到指定的框架”说明本机SDK版本低于项目要求去装对应版本的SDK或Visual Studio工作负载。我的习惯是直接装Visual Studio勾选“.NET 桌面开发”工作负载它会自动带齐WPF所需SDK和模板比单独装dotnet SDK省心。数据库方面常见OA源码用的是SQL ServerExpress版就够本地跑如果源码用的是MySQL则要装MySQL Server 8.0并注意连接串里SslMode的设置本地通常设成None。4.2 初始化数据库脚本和种子账号源码目录下通常会有一个Database或Sql文件夹放着:r的建库脚本。常见做法是先建库再执行表结构最后灌种子数据。不要双击脚本让它在SSMS里直接跑脚本之间可能依赖顺序# 在 SSMS 或 sqlcmd 中执行 sqlcmd -S . -E -i C:\source\OA\CreateDatabase.sql sqlcmd -S . -E -d OA_Demo -i C:\source\OA\Schema.sql sqlcmd -S . -E -d OA_Demo -i C:\source\OA\Seed.sql逻辑说明CreateDatabase.sql里只有CREATE DATABASE OA_Demo和一个USE语句Schema.sql建全部表按外键依赖顺序先主子表Seed.sql灌初始数据包括管理员账号、默认角色、菜单按钮。这里最常翻车的是Schema.sql和Seed.sql顺序不对外键表先建就会报错还有脚本里用了GO批量分隔符而sqlcmd在混合模式下有时会把GO后的变量作用域搞混。种子账号一般是admin / 123456或admin / Admin123。如果你登录失败先别怀疑代码去数据库里查Sys_User表的密码字段看存的到底是不是明文。如果是一串64位Hex那就是SHA256哈希初始密码要么在Seed.sql注释里要么在源码的Initialize方法里写死。4.3 修改连接串、编译启动与登录验证连接串一般集中在App.config或appsettings.json。改之前确认数据库实例名和登录方式Windows认证还是SQL账号认证两者写法不同connectionStrings add nameOaDb connectionStringServer.;DatabaseOA_Demo;User Idsa;Password你的密码;TrustServerCertificateTrue; providerNameSystem.Data.SqlClient / /connectionStrings如果用的是Windows认证登录把User Id和Password换成Integrated SecurityTrue即可。TrustServerCertificateTrue是本地开发常用的SQL Server 2022之后默认强制加密不加这个会在连接时直接抛“证书链验证失败”这是新手最容易卡在第一关的地方。改完配置重新编译。启动后按三个点验证是否真正跑通第一登录窗口能拉到验证码如果有第二用种子账号登录后主框架正常打开菜单按管理员角色完整显示第三待办中心拉到至少一条测试数据个人信息栏显示当前用户名。三点全过说明数据库、连接串、会话三件事都通了。如果卡在第二点去AppSession.Login()处加断点看登录返回的User是不是空卡在第三点去TodoRepository的方法上断点看SQL能否查到数据。5. WPF OA开发必踩的五个坑现象、原因、解决办法跑通只是开始。从“能跑”到“敢上线”中间隔着不少隐蔽问题。这一章列的是WPF项目里出现频率最高的五类翻车现场每一条都按“现象→原因→解决”写清楚。遇到类似症状直接对照处理。5.1 绑定不更新DataGrid改了数据界面没反应现象后台刷新集合后DataGrid还是旧数据或者新增的行不出现。原因集合类型用了ListT它没有通知机制或者虽然用了ObservableCollectionT但直接把整个集合变量重新赋值了。解决集合属性用ObservableCollectionT并且只在原集合实例上做增删不要整体替换。// 正确做法持有同一个实例只改内容 var todos new ObservableCollectionTodoItem(); // 刷新时不要这样做todos new ObservableCollectionTodoItem(rows); // 而是清空再逐个加原实例引用不变界面才能收到变更通知 todos.Clear(); foreach (var row in rows) { todos.Add(row); }逻辑说明ObservableCollection实现了INotifyCollectionChangedDataGrid会订阅它的集合变化事件但如果把属性指向一个新实例那个新实例没有通知旧绑定界面自然不动。如果数据量超过上万条Clear加Add会闪烁可以考虑给ObservableCollection加批量更新扩展但OA系统单页列表很少超过几千行这个写法够用。还要注意给集合里的对象属性赋值集合不会通知界面这种场景要回到第2章的INotifyPropertyChanged解决。5.2 后台线程操作UI偶发崩溃与闪退现象程序跑着跑着突然崩报“调用线程无法访问此对象因为它被另一个线程拥有”不是每次必现很玄学。原因在Task.Run或后台线程里直接改了TextBlock.Text、DataGrid.ItemsSource这类UI对象。WPF的UI控件只能在创建它的线程通常是主线程上操作。解决后台线程只做数据加载和计算回到UI线程后再更新属性。private async Task LoadPendingAsync() { var data await Task.Run(() _todoRepo.GetPendingList()); // 已经回到UI线程可以直接赋值触发绑定 PendingItems new ObservableCollectionTodoItem(data); }逻辑说明await会捕获当前同步上下文Task.Run返回后默认回到UI线程继续执行所以只要让UI更新代码出现在await之后就不会跨线程。踩坑点在于有些人为了“省事”在后台线程里直接Dispatcher.Invoke更新几十个控件这会让UI线程被高频任务堵死界面假死。正确思路是后台线程只干活UI线程只负责把结果贴到界面。5.3 权限只挡了界面服务端没校验现象菜单按钮按角色隐藏了但直接改代码调用或者用调试器把按钮设为可见就能执行审批、删除操作。原因权限只做了UI层过滤。WPF是客户端程序UI隐藏只是“看起来没有”不是“真正没有”。解决在业务层或数据访问层再做一次功能级校验尤其是审批、删除、导出、改密这类敏感操作。public void Approve(int approvalId) { var user AppSession.CurrentUser; if (!_permissionService.HasPermission(user, Approval.Approve)) { throw new UnauthorizedAccessException(当前角色无审批权限); } // 继续执行审批 }逻辑说明HasPermission查的是数据库里的角色-权限表和UI层的菜单隐藏共用一套权限数据但校验点是独立的。客户端里所有敏感操作都从这个函数过一遍等于把“按钮藏起来”升级成“服务端拦截”。接手老源码时先搜所有click事件里直接调Repository的地方这些点通常都没有权限校验是审计时最容易被打回的硬伤。5.4 枚举直接绑定列表显示一堆英文数字现象性别、审批状态、单据类型的列显示成0、1、Pending、Approved。原因枚举或状态码直接绑定到TextBlock没有做值转换。解决写一个IValueConverter在绑定路径上加Converter转换或者用DataType模板区分显示。public class ApprovalStatusConverter : IValueConverter { public object Convert(object value, Type targetType, object parameter, CultureInfo culture) { return value switch { 0 待审批, 1 已通过, 2 已驳回, 3 已撤回, _ 未知 }; } public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture) { throw new NotSupportedException(); } }逻辑说明单方向展示用Converter就够了ConvertBack不实现绑定改一行{Binding Status, Converter{StaticResource ApprovalStatusConverter}}。更进一步的方案是给不同状态套DataTemplate比如“已驳回”显示红色背景、“已通过”显示绿色但优先级不高等列表功能稳定后再美化。5.5 高分屏字体发虚DPI感知没设置现象在4K屏或125%、150%缩放的机器上窗口和字体发虚、模糊。原因进程没有声明DPI感知Windows用位图拉伸来适配高DPI看起来就是糊的。解决在app.manifest里声明PerMonitorV2application xmlnsurn:schemas-microsoft-com:asm.v3 windowsSettings dpiAwareness xmlnshttp://schemas.microsoft.com/SMI/2016/WindowsSettings PerMonitorV2 /dpiAwareness /windowsSettings /application参数说明PerMonitorV2会让WPF按每个显示器实际DPI重新布局文字和边框都清晰副作用是窗口拖到不同缩放的显示器时布局会重新计算复杂界面偶发错位。如果源码是net48老框架对PerMonitorV2支持不完整可能要退而用System.Windows.Media.VisualTreeHelper对HwndSource做适配这块就得具体报错具体看了。部署到公司环境前找一台高DPI的电脑实测一遍比在开发机上怎么调都清晰的经验可靠得多。6. 从能跑到能用上线前值得补的三个能力源码能跑通坑也排完了接下来是把项目推向可维护、可上线状态。我的习惯是按三个方向补能力优先级由高到低。第一个是本地缓存与离线处理。企业内网不是永远稳定网络抖动时审批单不能丢。常见做法是给待办和草稿箱加本地SQLite缓存网络好时同步网络差时落本地队列网络恢复后再重放。这个能力看着不起眼但运维那边对你的评价会从“能用”变成“好用”。第二个是全局异常处理与日志。不接日志的企业OA等于没有黑匣子报错只能靠用户截图。在App.xaml.cs里挂DispatcherUnhandledException和AppDomain.UnhandledException统一写文件至少要在出错时把堆栈和会话信息留下来。第三个是给审批流的状态机写单元测试——审批流程是最容易改坏的核心逻辑把状态流转抽成纯C#类不依赖UI和数据库测试跑起来才有意义后续改流程才敢放手。我自己接手WPF OA项目时第一件事永远是先梳理启动流程、全局异常和Session日志这三件事而不是急着改业务界面。因为这三件是地基地基不稳上面加什么都颤。如果你是按这套思路去啃一套源码建议也把“先跑通最小闭环、再补地基、最后动业务”作为默认顺序。希望这套从选型到踩坑再到进阶的梳理能帮你在WPF OA这条路上少走几段弯路把时间和精力花在真正值得投入的地方。本文还有配套的精品资源点击获取