H.Test.DefaultApplicationBase 示例项目学习教程一、概述H.Test.DefaultApplicationBase展示了如何使用 WPF-Control 框架的默认应用组合Default ApplicationBase。这是一个开箱即用的应用模板一键注册所有常用服务和模块。核心价值通过AddApplicationServices()一行代码注册所有默认服务快速搭建功能完整的应用框架。二、项目结构H.Test.DefaultApplicationBase/ ├── App.xaml # 应用入口XAML ├── App.xaml.cs # 应用入口代码 ├── MainWindow.xaml # 主窗口XAML ├── MainWindow.xaml.cs # 主窗口代码 └── H.Test.DefaultApplicationBase.csproj三、核心文件解析3.1 App.xamlApplicationBasex:ClassH.Test.DefaultApplicationBase.Appxmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentationxmlns:xhttp://schemas.microsoft.com/winfx/2006/xamlxmlns:localclr-namespace:H.Test.DefaultApplicationBaseApplication.ResourcesResourceDictionaryResourceDictionary.MergedDictionaries!-- 注释掉的手动配置因为使用默认组合会自动加载 --!--FontSizeTheme Type{x:Static FontSizeThemeType.Default} / LayoutTheme Type{x:Static LayoutThemeType.Default} / ColorTheme Type{x:Static ColorThemeType.Dark} /--!--DefaultStyle /--/ResourceDictionary.MergedDictionaries/ResourceDictionary/Application.Resources/ApplicationBase关键点继承ApplicationBase资源字典中的配置被注释掉因为默认应用组合会自动加载3.2 App.xaml.cs核心publicpartialclassApp:ApplicationBase{protectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);// 一键注册所有默认服务services.AddApplicationServices(x{// 配置模块选项x.UseModulesOptions(x{x.UseAboutOptions(xx.ProductNameTest);x.UseSplashScreenOptions(xx.ProductTTTTT);});// 配置主题选项x.UseThemeModuleOptions(x{x.UseThemeOptions(x{x.FontSizeFontSizeThemeType.Large;});});});}protectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);// 启用应用配置app.UseApplicationOptions();}protectedoverrideWindowCreateMainWindow(StartupEventArgse){returnnewMainWindow();}}三大核心步骤AddApplicationServices- 注册所有默认服务Lambda 配置- 自定义模块和主题选项UseApplicationOptions- 启用应用配置3.3 MainWindow.xamlWindowx:ClassH.Test.DefaultApplicationBase.MainWindowxmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentationxmlns:xhttp://schemas.microsoft.com/winfx/2006/xamlTitleMainWindowWidth800Height450Style{DynamicResource{x:Static WindowKeys.Default}}DockPanel!-- 顶部菜单 --MenuDockPanel.DockTopMenu.ResourcesStyleBasedOn{StaticResource {x:Static MenuItemKeys.BindCommand}}TargetTypeMenuItem//Menu.ResourcesMenuItemHeader帮助MenuItemCommand{ShowGuideCommand}/MenuItemCommand{ShowAboutCommand}/MenuItemCommand{ShowSettingCommand}/!-- 更多菜单项... --/MenuItem/Menu!-- 主内容区 --TabControlTabControl.ResourcesStyleBasedOn{StaticResource {x:Static ButtonKeys.Command}}TargetTypeButton//TabControl.Resources!-- Messages 标签页 --TabItemHeaderMessagesUniformGridButtonCommand{ShowMessageCommand}/ButtonCommand{ShowWaitCommand}/ButtonCommand{ShowPercentCommand}/ButtonCommand{ShowInfoNoticeMessageCommand Message我是 Info 消息}/ButtonCommand{ShowErrorNoticeMessageCommand Message我是 Error 消息}/ButtonCommand{ShowSuccessNoticeMessageCommand Message我是 Success 消息}/!-- 更多消息按钮... --/UniformGrid/TabItem!-- Modules 标签页 --TabItemHeaderModulesUniformGridButtonCommand{ShowAboutCommand}/ButtonCommand{ShowSettingCommand}/ButtonCommand{ShowFeedbackCommand}/!-- 更多模块按钮... --/UniformGrid/TabItem!-- Services 标签页 --TabItemHeaderServicesUniformGridButtonCommand{ShowLog4netPathCommand}//UniformGrid/TabItem/TabControl/DockPanel/Window四、默认服务详解4.1 AddApplicationServices 注册的服务publicstaticvoidAddApplicationServices(thisIServiceCollectionservices,ActionIDefaultApplicationOptionsoptionsnull){DefaultApplicationOptionsoptnewDefaultApplicationOptions();options?.Invoke(opt);// 1. 注册默认消息服务services.AddDefaultMessages();// 2. 注册默认模块服务services.AddDefaultModuleServices(opt.GetConfigOptionsActionIDefaultModuleOptions());// 3. 注册默认主题服务services.AddDefaultThemeServices(opt.GetConfigOptionsActionIDefaultThemeOptions());// 4. 注册日志服务services.AddLog4net();}4.2 默认消息服务AddDefaultMessages()注册服务功能AdornerDialogMessage对话框消息SnackMessage轻提示消息NoticeMessage通知消息FormMessage表单消息4.3 默认模块服务AddDefaultModuleServices()注册模块功能About关于页面Feedback反馈模块Guide新手引导Help帮助入口Setting设置页面Theme主题切换SplashScreen启动画面Login登录模块4.4 默认主题服务AddDefaultThemeServices()注册功能说明颜色主题浅色、深色、蓝色、紫色等字体大小小、中、大布局主题默认布局五、配置选项详解5.1 模块配置x.UseModulesOptions(x{// 配置关于页面x.UseAboutOptions(xx.ProductNameTest);// 配置启动页x.UseSplashScreenOptions(xx.ProductTTTTT);// 配置其他模块...});5.2 主题配置x.UseThemeModuleOptions(x{x.UseThemeOptions(x{// 设置字体大小x.FontSizeFontSizeThemeType.Large;// 添加颜色主题x.ColorResources.Add(newBlueDarkColorResource());x.ColorResources.Add(newBlueLightColorResource());});});六、命令系统6.1 消息命令命令功能ShowMessageCommand显示对话框ShowWaitCommand显示等待提示ShowPercentCommand显示进度百分比ShowEditCommand显示编辑对话框ShowInfoNoticeMessageCommand显示 Info 通知ShowErrorNoticeMessageCommand显示 Error 通知ShowSuccessNoticeMessageCommand显示 Success 通知ShowWarnNoticeMessageCommand显示 Warn 通知6.2 模块命令命令功能ShowAboutCommand显示关于页面ShowSettingCommand显示设置页面ShowFeedbackCommand显示反馈页面ShowGuideCommand显示新手引导ShowWebSiteCommand打开网站ShowSponsorCommand显示赞助页面6.3 服务命令命令功能ShowLog4netPathCommand显示日志文件路径七、运行项目7.1 步骤1. 打开 Visual Studio 2022 2. 打开解决方案Solution/WPF-Control.sln 3. 在解决方案资源管理器中找到 H.Test.DefaultApplicationBase 项目 4. 右键点击项目 → 设置为启动项目 5. 按 F5 运行7.2 预期效果运行后会看到启动页如果配置了登录页如果配置了主窗口顶部菜单栏包含帮助菜单三个标签页Messages、Modules、Services每个标签页有多个按钮点击可触发相应功能八、实际应用案例8.1 最小化配置publicpartialclassApp:ApplicationBase{protectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);// 最简单的一行代码注册所有服务services.AddApplicationServices();}protectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);app.UseApplicationOptions();}protectedoverrideWindowCreateMainWindow(StartupEventArgse){returnnewMainWindow();}}8.2 自定义配置publicpartialclassApp:ApplicationBase{protectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);services.AddApplicationServices(x{// 配置产品信息x.UseModulesOptions(opt{opt.UseAboutOptions(o{o.ProductName我的应用;o.Version1.0.0;o.Description这是一个示例应用;});opt.UseSplashScreenOptions(o{o.Product我的产品;o.Company我的公司;o.SleepMicroseconds2000;// 启动页停留 2 秒});});// 配置主题x.UseThemeModuleOptions(opt{opt.UseThemeOptions(o{o.FontSizeFontSizeThemeType.Medium;o.ColorResources.Add(newGrayDarkColorResource());o.ColorResources.Add(newGrayLightColorResource());});});});}protectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);app.UseApplicationOptions();}}8.3 添加自定义服务publicpartialclassApp:ApplicationBase{protectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);// 注册默认服务services.AddApplicationServices(x{// 配置选项...});// 添加自定义服务services.AddSingletonIDataService,DataService();services.AddTransientIMainViewModel,MainViewModel();}}九、对比学习9.1 与 H.Test.ApplicationBase 对比特性ApplicationBaseDefaultApplicationBase服务注册手动逐个注册一键批量注册配置复杂度高低灵活性高中等适用场景高度定制快速开发9.2 代码对比ApplicationBaseservices.AddAdornerDialogMessage();services.AddSnackMessage();services.AddSetting();services.AddTheme();services.AddAbout();services.AddHelp();// ... 需要注册很多服务DefaultApplicationBaseservices.AddApplicationServices(x{x.UseModulesOptions(x{x.UseAboutOptions(xx.ProductNameTest);});});十、常见问题10.1 服务未注册问题某些服务获取失败。解决1. 确保调用了 AddApplicationServices() 2. 检查配置选项是否正确 3. 确认 UseApplicationOptions() 已调用10.2 样式不显示问题界面没有应用样式。解决1. 确保 UseApplicationOptions() 已调用 2. 检查是否注释掉了手动资源加载 3. 确认主题服务已注册10.3 命令不执行问题按钮点击后命令不执行。解决1. 确保命令已注册到 IOC 容器 2. 检查命令绑定语法是否正确 3. 确认使用了正确的命令样式十一、总结通过学习H.Test.DefaultApplicationBase您掌握了一键注册AddApplicationServices()注册所有默认服务配置选项通过 Lambda 表达式自定义模块和主题命令系统使用内置命令快速实现功能最佳实践如何平衡灵活性和开发效率关键要点使用AddApplicationServices()简化服务注册通过 Lambda 配置自定义选项使用UseApplicationOptions()启用配置内置命令系统提供快速开发能力适用场景✅ 快速原型开发✅ 标准企业应用✅ 需要快速上线的项目❌ 需要高度定制的场景这是构建 WPF-Control 应用的推荐起点可以在默认基础上逐步添加自定义功能。
