简介:这份资源是面向WPF初学者与桌面开发进阶者的MVVM完整示例,以登录窗口LoginDemo为载体,解决从传统事件驱动转向MVVM分层开发时View与ViewModel如何解耦、命令与绑定如何落地的问题。压缩包共71个文件、约258KB,以31个cs源码文件为核心,配合3个xaml界面、2个baml编译资源及dll、config、sln、csproj等工程与依赖文件,构成可直接用Visual Studio打开的完整解决方案。示例覆盖用户名密码属性绑定、ICommand与RelayCommand命令、PasswordBox安全绑定、RadioButton记住密码、EventToCommand处理窗口关闭、输入数据验证以及登录成功后的窗口导航等关键知识点,目录按ViewModel、Common、Login等模块划分,结构清晰。已有10153人学习下载,适合对照源码理解MVVM各环节的职责边界,并在此基础上改造为自己的登录模块。
1. 登录窗口这件小事,为什么值得用一套完整 MVVM 方案来讲
很多人第一次接触 WPF MVVM,都是从登录窗口开始的:两个输入框、一个按钮、一次校验,看起来十分钟能写完。但真正把它写“对”的人不多——密码校验逻辑塞进后台代码、按钮点击里直接弹窗、ViewModel 里 new 出一个 Window,这些写法在 Demo 里跑得通,一旦要加记住密码、错误提示、登录中禁用按钮、单元测试,就全乱套了。这套 WPF MVVM 完整示例(登录窗口)要解决的正是这个断层:用一个最小但闭环的场景,把命令绑定、属性通知、校验反馈、窗口关闭与视图切换这几件事一次讲透。它适合正在做课程设计、毕业设计,或者需要给团队交一份可复用 WPF 项目骨架的人,照着改就能落地。
2. 需求与选型:登录窗口背后要拆出的四类职责
2.1 先把需求写清楚,别急着建项目
登录窗口看着简单,但把它当成一个“完整方案”来做,需求至少要拆成四层。第一层是输入:用户名、密码两个字段,密码需要掩码显示,输入过程中要能实时反馈格式问题。第二层是动作:点击登录触发校验,校验期间按钮不可重复点击,要有“登录中”的状态。第三层是结果:成功则关闭登录窗口并进入主界面,失败则在窗口内给出明确提示,而不是弹一个 MessageBox 了事。第四层是可测试性:校验规则、登录流程要能脱离 UI 单独跑,这是 MVVM 真正的价值所在。
我一般会把这几层写成一张职责表,避免写着写着又把逻辑漏回后台代码:
| 职责 | 归属 | 不该出现在 |
|---|---|---|
| 输入内容与格式校验 | ViewModel | 窗口后台代码 |
| 按钮可用状态、登录中状态 | ViewModel | XAML 触发器里硬编码 |
| 窗口关闭、视图切换 | View 或服务层 | ViewModel 直接 new Window |
| 数据访问(模拟校验) | 服务接口 | ViewModel 里写死连接串 |
这张表不是形式主义。项目里最常见的翻车,就是“校验逻辑一半在 ViewModel、一半在 Click 事件里”,后期改规则要改两处,测试也测不了。把职责先钉死,后面每个模块该放哪就清楚了。
2.2 技术选型:为什么是 MVVM 而不是 Code-Behind
WPF 本身支持 Code-Behind,登录窗口用事件处理也能写完。但选 MVVM 的理由很实在:一是绑定是双向的,输入框内容变化能自动同步到 ViewModel,不用手动取值;二是命令(ICommand)能把“按钮能不能点”变成 ViewModel 里的一个布尔属性,UI 自动跟着变;三是 ViewModel 不依赖任何 WPF 控件类型,可以直接在单元测试里 new 出来跑。
这套示例的技术栈就是纯 WPF + .NET 自带的 MVVM 基础设施,不引入第三方 MVVM 框架。原因也简单:登录窗口这个体量,引入 Prism 或 CommunityToolkit 反而让初学者看不清哪些是框架魔法、哪些是 MVVM 本身。手写一个 RelayCommand 和 ViewModelBase,代码量不到一百行,但每一行都能讲清楚为什么这么写。等这套骨架跑通了,再换框架只是替换基类的事。
提示:如果你的课程设计明确要求使用某个 MVVM 框架,把这里的 ViewModelBase 和 RelayCommand 换成框架提供的等价物即可,分层结构不用动。
3. 总体设计:三层结构与四个核心模块的职责划分
3.1 分层结构:View、ViewModel、Service 各管一段
整个示例按经典三层来组织,但要注意 WPF 里“层”的边界是靠引用关系守住的,不是靠文件夹名字。View 层只放 XAML 和极少量必要的后台代码(比如窗口加载时设置焦点),它通过 DataContext 拿到 ViewModel。ViewModel 层持有输入属性、命令和状态,通过构造函数注入一个登录服务接口。Service 层负责真正的校验逻辑,示例里用一个模拟实现,真实项目里换成调用后端接口即可。
依赖方向是单向的:View 依赖 ViewModel,ViewModel 依赖 Service 接口,Service 实现不反向依赖任何 UI。这条线守住了,ViewModel 就能在测试项目里独立实例化,不需要启动 WPF 应用。很多人的 ViewModel 测试跑不起来,根子就在某处偷偷引用了System.Windows.MessageBox或者直接 new 了窗口。
3.2 四个核心模块:基类、命令、服务、窗口协调
拆到模块级别,这套示例有四个必须讲清楚的部分。第一个是ViewModelBase,实现INotifyPropertyChanged,提供SetProperty泛型方法,所有属性通知都走它。第二个是RelayCommand,实现ICommand,支持执行委托和可执行判断委托,并在判断条件变化时主动触发CanExecuteChanged。第三个是ILoginService及其模拟实现,把“用户名密码对不对”这件事从 UI 里彻底剥离。第四个是窗口协调,登录成功后怎么关窗、怎么开主界面,这块用事件或一个轻量的导航服务来处理,绝不让 ViewModel 直接操作窗口对象。
这四个模块的划分不是拍脑袋,而是对应了 MVVM 落地时最容易出问题的四个点:属性不通知、命令状态不刷新、业务逻辑和 UI 耦合、窗口生命周期失控。每个模块下面都会给出可抄的代码和参数说明。
4. 关键模块实现:从属性通知到登录流程的完整代码
4.1 ViewModelBase 与属性通知:别让绑定变成玄学
属性通知是 MVVM 的地基。WPF 的绑定引擎靠PropertyChanged事件知道值变了,没触发就永远显示旧值,这就是很多人说的“绑定玄学”。手写一个基类,把通知逻辑收口:
using System.ComponentModel; using System.Runtime.CompilerServices; public abstract class ViewModelBase : INotifyPropertyChanged { public event PropertyChangedEventHandler? PropertyChanged; // 泛型 SetProperty:值真的变了才通知,避免无谓刷新 protected bool SetProperty<T>(ref T field, T value, [CallerMemberName] string? propertyName = null) { if (EqualityComparer<T>.Default.Equals(field, value)) return false; field = value; PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); return true; } }SetProperty的三个参数各有讲究:ref field传字段引用,赋值在方法内部完成;value是新值;propertyName用[CallerMemberName]自动填充,调用时不用手写属性名字符串,改属性名时编译器会帮你检查。先比较再赋值这一步很关键——如果每次 set 都无脑通知,绑定会反复刷新,输入框光标位置都可能被打断。这个基类后面所有 ViewModel 都继承它,属性写法统一成set => SetProperty(ref _userName, value);。
4.2 RelayCommand:按钮什么时候能点,交给它判断
命令是 MVVM 里替代 Click 事件的核心。一个合格的 RelayCommand 要支持两件事:执行逻辑,以及“当前能不能执行”的判断。后者决定了登录按钮在输入为空或正在登录时是否置灰:
using System.Windows.Input; public class RelayCommand : ICommand { private readonly Action<object?> _execute; private readonly Predicate<object?>? _canExecute; public RelayCommand(Action<object?> execute, Predicate<object?>? canExecute = null) { _execute = execute ?? throw new ArgumentNullException(nameof(execute)); _canExecute = canExecute; } public bool CanExecute(object? parameter) => _canExecute?.Invoke(parameter) ?? true; public void Execute(object? parameter) => _execute(parameter); public event EventHandler? CanExecuteChanged; // 手动触发重新求值,属性变化后调用 public void RaiseCanExecuteChanged() => CanExecuteChanged?.Invoke(this, EventArgs.Empty); }这里有个容易忽略的点:WPF 自带的CommandManager.RequerySuggested会在很多 UI 事件后自动重新求值,但它时机不可控,输入框刚变、按钮状态可能还没刷新。所以我一般不用它,而是在 ViewModel 里当UserName、Password、IsBusy变化时,显式调用LoginCommand.RaiseCanExecuteChanged()。这样按钮状态和业务状态严格同步,不会出现“明明输入了却点不了”的怪现象。execute参数用object?是为了兼容带命令参数的场景,登录这里用不到参数,传 null 即可。
4.3 LoginViewModel:输入、校验、状态三件事收在一处
ViewModel 是这套方案的中枢。它持有输入属性、登录命令、错误提示和忙碌状态,所有 UI 需要的东西都以属性形式暴露:
public class LoginViewModel : ViewModelBase { private readonly ILoginService _loginService; private string _userName = string.Empty; private string _password = string.Empty; private string? _errorMessage; private bool _isBusy; public LoginViewModel(ILoginService loginService) { _loginService = loginService; LoginCommand = new RelayCommand(async _ => await LoginAsync(), _ => CanLogin()); } public string UserName { get => _userName; set { if (SetProperty(ref _userName, value)) RefreshCommandState(); } } public string Password { get => _password; set { if (SetProperty(ref _password, value)) RefreshCommandState(); } } public string? ErrorMessage { get => _errorMessage; private set => SetProperty(ref _errorMessage, value); } public bool IsBusy { get => _isBusy; private set { if (SetProperty(ref _isBusy, value)) RefreshCommandState(); } } public RelayCommand LoginCommand { get; } // 登录成功的通知,View 层订阅后关窗、开主界面 public event EventHandler? LoginSucceeded; private bool CanLogin() => !IsBusy && !string.IsNullOrWhiteSpace(UserName) && Password.Length >= 6; private void RefreshCommandState() => LoginCommand.RaiseCanExecuteChanged(); private async Task LoginAsync() { IsBusy = true; ErrorMessage = null; try { var ok = await _loginService.ValidateAsync(UserName, Password); if (ok) LoginSucceeded?.Invoke(this, EventArgs.Empty); else ErrorMessage = "用户名或密码不正确"; } catch (Exception ex) { ErrorMessage = "登录过程出现异常,请稍后重试"; } finally { IsBusy = false; } } }几个设计点值得展开。CanLogin里把“非忙碌、用户名非空、密码至少六位”三个条件写在一起,UI 上按钮的可用状态就完全由它决定,不需要在 XAML 里写任何触发器。LoginSucceeded用事件而不是直接关窗,是为了让 ViewModel 保持对窗口的无知——订阅方是 View 或窗口协调器,它来决定关哪个窗、开哪个界面。LoginAsync里IsBusy的置位和复位放在 try/finally,保证异常时按钮不会永远卡在禁用状态,这是异步命令最常见的坑。ErrorMessage的 setter 是 private,外部只能读,避免 View 层乱改提示文案。
4.4 登录服务与窗口协调:把“关窗”这件事挪出 ViewModel
服务接口把校验逻辑隔离出来,示例里给一个模拟实现,真实项目替换成 HTTP 调用即可:
public interface ILoginService { Task<bool> ValidateAsync(string userName, string password); } public class MockLoginService : ILoginService { public async Task<bool> ValidateAsync(string userName, string password) { // 模拟网络延迟,真实项目替换为后端接口调用 await Task.Delay(800); return userName == "admin" && password == "123456"; } }窗口协调放在 View 侧,登录窗口的后台代码只做一件事:订阅LoginSucceeded,然后关闭自己、打开主窗口。这段代码很短,但边界必须清楚——它属于 View 的职责,不是 ViewModel 的。XAML 里绑定就三处关键:两个 TextBox 的Text绑到UserName、Password(密码框用PasswordBox时注意它不支持直接绑定,通常的做法是用附加属性或后台同步,示例里为简化用普通 TextBox 加掩码字符),按钮的Command绑到LoginCommand,错误提示的TextBlock绑到ErrorMessage并用BooleanToVisibilityConverter控制显隐。
5. 避坑与排查:这套骨架最容易翻车的五个地方
5.1 绑定不生效,界面像被冻住
现象是输入框改了值,ViewModel 里断点打不到,或者反过来 ViewModel 改了值界面不动。原因通常有两个:一是属性 setter 没走SetProperty,直接给字段赋值;二是DataContext没设对,XAML 里绑定路径找不到源。解决办法是先看输出窗口有没有绑定错误日志(WPF 绑定失败会打印路径),再检查窗口构造时是否DataContext = new LoginViewModel(...)。我习惯在开发期把绑定错误当成异常级别来看,别让它静默失败。
5.2 登录按钮一直灰着,输入了也点不了
现象是用户名密码都填了,按钮还是禁用。原因多半是CanExecuteChanged没触发——属性变了但没调用RaiseCanExecuteChanged,WPF 不知道要重新求值。解决是在UserName、Password、IsBusy的 setter 里统一调RefreshCommandState()。另一个隐蔽原因是CanLogin里用了Password.Length,而密码为 null 时直接抛异常被吞掉,判断结果变成 false。加个空值保护就能定位。
5.3 异步登录时按钮能重复点,弹出两个主窗口
现象是网络慢的时候连点登录,最后开了两个主界面。原因是命令执行期间没有禁用自身,async void式的执行让CanExecute来不及刷新。解决办法是LoginAsync一进来就IsBusy = true,而CanLogin里包含!IsBusy,配合RaiseCanExecuteChanged让按钮立刻置灰。注意IsBusy的复位一定放 finally,否则一次异常之后按钮永久禁用,用户只能重启程序。
5.4 ViewModel 里 new 了 Window,单元测试直接崩
现象是给 ViewModel 写测试,一跑就报“调用线程必须是 STA”或者找不到资源。原因是 ViewModel 里直接new MainWindow().Show()。解决办法是把窗口操作抽成事件或导航服务接口,ViewModel 只负责发信号。测试时订阅事件断言“登录成功信号发出了”即可,完全不碰 UI 线程。这条是 MVVM 可测试性的底线,破了这条,前面所有分层都白做。
5.5 密码框绑定不上,明文还留在内存里
现象是PasswordBox.Password不能直接双向绑定,硬绑会报错。原因是这个属性出于安全考虑不是依赖属性。通常的做法是用附加属性把Password同步到一个 ViewModel 属性,或者干脆在登录命令执行时从 View 传参。示例里为了讲清主流程用了普通输入框,真实项目里建议用附加属性方案,并在登录完成后清空密码字段,减少明文驻留时间。这一点在需要过安全评审的项目里会被专门提出来。
6. 验收与答辩:怎么证明这套 MVVM 是真的跑通了
验收这套方案,别只看“能登录进去”。我一般按四步走,每一步都有可观察的证据。第一步,跑单元测试:给LoginViewModel注入一个假的ILoginService,断言三件事——用户名为空时LoginCommand.CanExecute为 false;密码错误时ErrorMessage被赋值;登录成功时LoginSucceeded事件被触发。这三条过了,说明 ViewModel 真的脱离了 UI。第二步,手动验证状态机:输入过程中观察按钮置灰与恢复,点击后观察按钮禁用、错误提示出现、异常场景下按钮能恢复,这是命令和状态设计的验收。第三步,检查依赖方向:在解决方案里看 ViewModel 项目是否引用了任何 WPF 窗口类型,没有引用才算分层干净。第四步,替换服务实现:把MockLoginService换成一个必然抛异常的实现,确认界面给出友好提示而不是崩溃,这验证了异常兜底。
答辩时最容易被问的两个问题,提前准备好答案。一个是“为什么不用 Code-Behind”,回答落在可测试性和职责分离上,最好现场演示那个单元测试。另一个是“登录成功后窗口怎么关的”,回答落在事件或导航服务上,强调 ViewModel 不知道窗口存在。如果时间允许,把RelayCommand的CanExecuteChanged手动触发讲清楚,这是区分“背过 MVVM 概念”和“真写过”的分水岭。
| 验收项 | 通过标准 | 检查方式 |
|---|---|---|
| 属性通知 | 改 ViewModel 属性,界面同步更新 | 断点 + 界面观察 |
| 命令状态 | 输入为空或忙碌时按钮禁用 | 手动操作 |
| 异常兜底 | 服务抛异常时提示友好、按钮恢复 | 替换服务实现 |
| 分层干净 | ViewModel 不引用窗口类型 | 查看项目引用 |
| 可测试性 | 三条单元测试全绿 | 测试运行器 |
血泪经验是:别等到答辩前一天才跑测试,很多分层问题在写测试的第一分钟就暴露了。从那以后我每次搭 WPF 项目骨架,都强制先把 ViewModelBase、RelayCommand 和一个能跑的单元测试立起来,再往里填业务,返工率低很多。希望帮到你。
本文还有配套的精品资源,点击获取