H.Test.DefaultApplicationBase-默认应用组合

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.xaml

<ApplicationBasex:Class="H.Test.DefaultApplicationBase.App"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"xmlns:local="clr-namespace:H.Test.DefaultApplicationBase"><Application.Resources><ResourceDictionary><ResourceDictionary.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(x=>x.ProductName="Test");x.UseSplashScreenOptions(x=>x.Product="TTTTT");});// 配置主题选项x.UseThemeModuleOptions(x=>{x.UseThemeOptions(x=>{x.FontSize=FontSizeThemeType.Large;});});});}protectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);// 启用应用配置app.UseApplicationOptions();}protectedoverrideWindowCreateMainWindow(StartupEventArgse){returnnewMainWindow();}}

三大核心步骤：

1. AddApplicationServices- 注册所有默认服务
2. Lambda 配置- 自定义模块和主题选项
3. UseApplicationOptions- 启用应用配置

3.3 MainWindow.xaml

<Windowx:Class="H.Test.DefaultApplicationBase.MainWindow"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"Title="MainWindow"Width="800"Height="450"Style="{DynamicResource{x:Static WindowKeys.Default}}"><DockPanel><!-- 顶部菜单 --><MenuDockPanel.Dock="Top"><Menu.Resources><StyleBasedOn="{StaticResource {x:Static MenuItemKeys.BindCommand}}"TargetType="MenuItem"/></Menu.Resources><MenuItemHeader="帮助"><MenuItemCommand="{ShowGuideCommand}"/><MenuItemCommand="{ShowAboutCommand}"/><MenuItemCommand="{ShowSettingCommand}"/><!-- 更多菜单项... --></MenuItem></Menu><!-- 主内容区 --><TabControl><TabControl.Resources><StyleBasedOn="{StaticResource {x:Static ButtonKeys.Command}}"TargetType="Button"/></TabControl.Resources><!-- Messages 标签页 --><TabItemHeader="Messages"><UniformGrid><ButtonCommand="{ShowMessageCommand}"/><ButtonCommand="{ShowWaitCommand}"/><ButtonCommand="{ShowPercentCommand}"/><ButtonCommand="{ShowInfoNoticeMessageCommand Message=我是 Info 消息}"/><ButtonCommand="{ShowErrorNoticeMessageCommand Message=我是 Error 消息}"/><ButtonCommand="{ShowSuccessNoticeMessageCommand Message=我是 Success 消息}"/><!-- 更多消息按钮... --></UniformGrid></TabItem><!-- Modules 标签页 --><TabItemHeader="Modules"><UniformGrid><ButtonCommand="{ShowAboutCommand}"/><ButtonCommand="{ShowSettingCommand}"/><ButtonCommand="{ShowFeedbackCommand}"/><!-- 更多模块按钮... --></UniformGrid></TabItem><!-- Services 标签页 --><TabItemHeader="Services"><UniformGrid><ButtonCommand="{ShowLog4netPathCommand}"/></UniformGrid></TabItem></TabControl></DockPanel></Window>

四、默认服务详解

4.1 AddApplicationServices 注册的服务

publicstaticvoidAddApplicationServices(thisIServiceCollectionservices,Action<IDefaultApplicationOptions>options=null){DefaultApplicationOptionsopt=newDefaultApplicationOptions();options?.Invoke(opt);// 1. 注册默认消息服务services.AddDefaultMessages();// 2. 注册默认模块服务services.AddDefaultModuleServices(opt.GetConfigOptions<Action<IDefaultModuleOptions>>());// 3. 注册默认主题服务services.AddDefaultThemeServices(opt.GetConfigOptions<Action<IDefaultThemeOptions>>());// 4. 注册日志服务services.AddLog4net();}

4.2 默认消息服务

AddDefaultMessages()注册：

4.3 默认模块服务

AddDefaultModuleServices()注册：

4.4 默认主题服务

AddDefaultThemeServices()注册：

五、配置选项详解

5.1 模块配置

x.UseModulesOptions(x=>{// 配置关于页面x.UseAboutOptions(x=>x.ProductName="Test");// 配置启动页x.UseSplashScreenOptions(x=>x.Product="TTTTT");// 配置其他模块...});

5.2 主题配置

x.UseThemeModuleOptions(x=>{x.UseThemeOptions(x=>{// 设置字体大小x.FontSize=FontSizeThemeType.Large;// 添加颜色主题x.ColorResources.Add(newBlueDarkColorResource());x.ColorResources.Add(newBlueLightColorResource());});});

六、命令系统

6.1 消息命令

6.2 模块命令

6.3 服务命令

七、运行项目

7.1 步骤

1. 打开 Visual Studio 2022 2. 打开解决方案：Solution/WPF-Control.sln 3. 在解决方案资源管理器中找到 H.Test.DefaultApplicationBase 项目 4. 右键点击项目 → 设置为启动项目 5. 按 F5 运行

7.2 预期效果

运行后会看到：

1. 启动页（如果配置了）
2. 登录页（如果配置了）
3. 主窗口：
   • 顶部菜单栏包含"帮助"菜单
   • 三个标签页：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.Version="1.0.0";o.Description="这是一个示例应用";});opt.UseSplashScreenOptions(o=>{o.Product="我的产品";o.Company="我的公司";o.SleepMicroseconds=2000;// 启动页停留 2 秒});});// 配置主题x.UseThemeModuleOptions(opt=>{opt.UseThemeOptions(o=>{o.FontSize=FontSizeThemeType.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.AddSingleton<IDataService,DataService>();services.AddTransient<IMainViewModel,MainViewModel>();}}

九、对比学习

9.1 与 H.Test.ApplicationBase 对比

9.2 代码对比

ApplicationBase：

services.AddAdornerDialogMessage();services.AddSnackMessage();services.AddSetting();services.AddTheme();services.AddAbout();services.AddHelp();// ... 需要注册很多服务

DefaultApplicationBase：

services.AddApplicationServices(x=>{x.UseModulesOptions(x=>{x.UseAboutOptions(x=>x.ProductName="Test");});});

十、常见问题

10.1 服务未注册

问题：某些服务获取失败。

解决：

1. 确保调用了 AddApplicationServices() 2. 检查配置选项是否正确 3. 确认 UseApplicationOptions() 已调用

10.2 样式不显示

问题：界面没有应用样式。

解决：

1. 确保 UseApplicationOptions() 已调用 2. 检查是否注释掉了手动资源加载 3. 确认主题服务已注册

10.3 命令不执行

问题：按钮点击后命令不执行。

解决：

1. 确保命令已注册到 IOC 容器 2. 检查命令绑定语法是否正确 3. 确认使用了正确的命令样式

十一、总结

通过学习H.Test.DefaultApplicationBase，您掌握了：

1. 一键注册：AddApplicationServices()注册所有默认服务
2. 配置选项：通过 Lambda 表达式自定义模块和主题
3. 命令系统：使用内置命令快速实现功能
4. 最佳实践：如何平衡灵活性和开发效率

关键要点：

• 使用AddApplicationServices()简化服务注册
• 通过 Lambda 配置自定义选项
• 使用UseApplicationOptions()启用配置
• 内置命令系统提供快速开发能力

适用场景：

• ✅ 快速原型开发
• ✅ 标准企业应用
• ✅ 需要快速上线的项目
• ❌ 需要高度定制的场景

这是构建 WPF-Control 应用的推荐起点，可以在默认基础上逐步添加自定义功能。