Win Application Framework (WAF)错误处理策略全局异常与用户友好提示【免费下载链接】wafWin Application Framework (WAF) is a lightweight Framework that helps you to create well structured XAML Applications.项目地址: https://gitcode.com/gh_mirrors/waf/waf在开发Windows桌面应用程序时错误处理策略是确保应用稳定性和用户体验的关键。Win Application Framework (WAF)作为一款轻量级XAML应用框架提供了一套完整的错误处理机制帮助开发者构建健壮的应用程序。本文将详细介绍WAF的全局异常处理策略和用户友好提示的实现方式。 为什么需要专业的错误处理在桌面应用中未处理的异常会导致应用崩溃给用户带来糟糕的体验。WAF通过以下策略解决这个问题防止应用崩溃- 捕获未处理异常记录错误信息- 便于调试和排查提供友好提示- 让用户理解发生了什么数据验证- 防止无效数据进入系统️ WAF的全局异常处理机制WAF采用多层级的异常处理策略确保应用程序的稳定性1. 应用级别的全局异常捕获在WAF应用中全局异常处理是通过AppDomain.CurrentDomain.UnhandledException事件实现的// 在App.xaml.cs中 #if (!DEBUG) AppDomain.CurrentDomain.UnhandledException OnUnhandledException; TaskScheduler.UnobservedTaskException (_, ea) Log.Default.Warn(ea.Exception, UnobservedTaskException); #endif这种设计只在发布版本中启用全局异常处理开发调试时则允许异常直接抛出便于调试。2. 用户友好的错误提示当发生未处理异常时WAF会向用户显示友好的错误信息private void OnUnhandledException(object sender, UnhandledExceptionEventArgs e) { var ex e.ExceptionObject as Exception ?? throw new InvalidOperationException(Unknown exception object); Log.Default.Error(ex, UnhandledException; IsTerminating{0}, e.IsTerminating); var message string.Format(CultureInfo.CurrentCulture, Presentation.Properties.Resources.UnknownError, ex); if (MainWindow?.IsVisible true) { MessageBox.Show(message, ApplicationInfo.ProductName, MessageBoxButton.OK, MessageBoxImage.Error); } else { MessageBox.Show(message, ApplicationInfo.ProductName, MessageBoxButton.OK, MessageBoxImage.Error, MessageBoxResult.OK, MessageBoxOptions.ServiceNotification); } } 数据验证与错误处理WAF通过ValidatableModel基类提供了强大的数据验证功能这是用户输入验证的核心机制。ValidatableModel类的作用ValidatableModel位于src/System.Waf/System.Waf/System.Waf.Core/Foundation/ValidatableModel.cs它实现了INotifyDataErrorInfo接口提供实时数据验证- 属性更改时自动验证错误信息收集- 收集所有验证错误UI绑定支持- 与WPF/XAML数据绑定无缝集成使用数据注解进行验证WAF支持使用C#数据注解进行声明式验证public class Person : ValidatableModel, IFormattable { [Required(ErrorMessageResourceName nameof(Resources.FirstnameMandatory), ErrorMessageResourceType typeof(Resources))] [StringLength(30, ErrorMessageResourceName nameof(Resources.FirstnameMaxLength), ErrorMessageResourceType typeof(Resources))] public string Firstname { get; set SetPropertyAndValidate(ref field, value); } ; [EmailAddress(ErrorMessageResourceName nameof(Resources.EmailInvalid), ErrorMessageResourceType typeof(Resources))] public string? Email { get; set SetPropertyAndValidate(ref field, value ? null : value); } }验证错误处理流程当用户输入无效数据时WAF的处理流程如下属性设置触发验证- 通过SetPropertyAndValidate方法收集验证错误- 使用ValidationHelper.Validate更新错误状态- 自动更新HasErrors属性通知UI更新- 触发ErrorsChanged事件 业务逻辑错误处理除了数据验证WAF还提供了完整的业务逻辑错误处理机制1. 控制器层的错误处理在控制器中WAF使用try-catch块捕获业务逻辑异常public async Taskbool SaveCore() { Log.Default.Info(Save changes in database.); try { await entityService.SaveChanges().ConfigureAwait(false); return true; } catch (Exception ex) { Log.Default.Error(ex, SaveChangesAsync); } return false; }2. 验证失败时的用户提示当数据验证失败时WAF会向用户显示具体的错误信息var errors entities.OfTypeValidatableModel().Where(x x.HasErrors).ToArray(); if (errors.Any()) { var errorMessages errors.Select(x string.Format(CultureInfo.CurrentCulture, Resources.EntityInvalid, EntityToString(x), string.Join(Environment.NewLine, x.Errors))); Log.Default.Warn(Abort save changes because of errors: {0}, string.Join(; , errorMessages)); messageService.ShowError(shellService.ShellView, Resources.SaveErrorInvalidEntities, string.Join(Environment.NewLine, errorMessages)); return; } 错误处理的最佳实践基于WAF的示例应用我们总结出以下最佳实践1. 分层错误处理层级处理方式目的UI层数据绑定验证即时反馈用户输入错误业务层控制器异常处理处理业务逻辑错误数据层数据库异常处理处理数据访问错误应用层全局异常处理防止应用崩溃2. 日志记录策略WAF使用NLog进行日志记录建议的日志级别Error- 记录未处理异常和严重错误Warn- 记录验证失败等警告信息Info- 记录重要操作如保存数据Debug- 开发时记录详细调试信息3. 用户友好的错误消息错误消息应该使用本地化资源文件如Resources.resx避免技术术语提供解决问题的建议在适当的情况下提供错误代码 实际应用示例让我们看看WAF示例应用中的错误处理实践示例1加载数据时的错误处理try { Persons await entityService.Persons.ToArrayAsync().ConfigureAwait(false); } catch (Exception ex) { Log.Default.Error(ex, LoadPersons); messageService.ShowError(shellService.ShellView, Resources.LoadErrorPersons); }示例2发送邮件时的错误处理try { Process.Start(new ProcessStartInfo(mailto: emailAddress) { UseShellExecute true }); } catch (Exception e) { Log.Default.Error(e, Cannot create a new email); messageService.ShowError(shellService.ShellView, Resources.CreateEmailError); } 错误处理的效果与优势使用WAF的错误处理策略带来的好处提高应用稳定性- 减少崩溃和未处理异常改善用户体验- 友好的错误提示简化调试过程- 详细的日志记录代码可维护性- 统一的错误处理模式国际化支持- 通过资源文件支持多语言 自定义错误处理WAF的错误处理机制是可扩展的开发者可以根据需要自定义验证逻辑- 继承ValidatableModel并重写验证方法扩展错误类型- 创建自定义异常类修改错误显示方式- 自定义错误提示对话框集成第三方日志- 替换或扩展日志系统 总结Win Application Framework (WAF)提供了一套完整的错误处理策略从全局异常捕获到细粒度数据验证再到用户友好的错误提示全方位保障应用程序的稳定性和用户体验。通过使用WAF的ValidatableModel基类和统一的错误处理模式开发者可以快速构建健壮的桌面应用程序。无论您是WAF的新手还是经验丰富的开发者掌握这些错误处理技巧都将帮助您创建更可靠、更专业的Windows桌面应用。【免费下载链接】wafWin Application Framework (WAF) is a lightweight Framework that helps you to create well structured XAML Applications.项目地址: https://gitcode.com/gh_mirrors/waf/waf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考