如何新建自己的应用

建议步骤如下。1 创建 WPF 项目项目文件至少包含TargetFrameworknet7.0-windows/TargetFrameworkUseWPFtrue/UseWPF2 引用基础库至少引用HeBianGu.Base.WpfBaseHeBianGu.General.WpfControlLib根据需要再引用HeBianGu.Control.MessageHeBianGu.Window.MessageDialogHeBianGu.Service.AnimationHeBianGu.Systems.Setting其他控件或系统模块3 修改App.xaml让应用继承框架应用基类h:ApplicationBasex:ClassYourApp.Appxmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentationxmlns:xhttp://schemas.microsoft.com/winfx/2006/xamlxmlns:hhttps://github.com/HeBianGu/h:ApplicationBase4 修改App.xaml.cs基本结构publicpartialclassApp:ApplicationBase{protectedoverrideMainWindowBaseCreateMainWindow(StartupEventArgse){returnnewMainWindow();}protectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);services.AddWindowAnimation();services.AddMessageProxy();services.AddWindowDialog();}protectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);app.UseLocalTheme(x{x.ThemeTypeThemeType.Light;x.LanguageLanguage.Chinese;});}}5 主窗口主窗口可以参考示例项目中的MainWindowBase用法。初学者建议直接复制模板项目结构再逐步删减。推荐模板Source/Template/HeBianGu.Template.Main如何新建自己的应用 目录准备工作创建 WPF 项目引用基础库修改 App.xaml修改 App.xaml.cs创建主窗口运行应用常见问题准备工作 环境要求软件版本要求说明Visual Studio2022开发工具.NET7.0运行时环境WPF-ControlBase最新版基础框架 获取框架源码首先你需要获取 WPF-ControlBase 框架的源码打开浏览器访问 GitHub 仓库https://github.com/HeBianGu/WPF-ControlBase点击 “Code” 按钮选择 “Download ZIP” 下载源码解压到本地目录例如C:\Projects\WPF-ControlBase-master创建 WPF 项目 步骤1新建项目打开 Visual Studio 2022点击 “创建新项目”在搜索框中输入 “WPF”选择 “WPF 应用” 模板点击 “下一步” 步骤2配置项目项目名称输入你的项目名称例如MyFirstApp位置选择项目保存路径例如C:\Projects\MyFirstApp解决方案名称可以和项目名称相同或者使用解决方案名点击 “创建”✅ 步骤3验证项目配置创建完成后打开项目文件MyFirstApp.csproj确保包含以下内容ProjectSdkMicrosoft.NET.SdkPropertyGroupOutputTypeWinExe/OutputTypeTargetFrameworknet7.0-windows/TargetFrameworkUseWPFtrue/UseWPF/PropertyGroup/Project如果TargetFramework不是net7.0-windows请手动修改。引用基础库 方式1项目引用推荐在解决方案资源管理器中右键点击项目名称选择 “添加” → “项目引用”在 “项目” 标签页中勾选以下项目HeBianGu.Base.WpfBaseHeBianGu.General.WpfControlLib点击 “确定” 方式2NuGet 引用备选如果框架已发布到 NuGet可以通过 NuGet 包管理器安装右键点击项目名称选择 “管理 NuGet 程序包”在 “浏览” 标签页中搜索HeBianGu.Base.WpfBaseHeBianGu.General.WpfControlLib点击 “安装” 根据需要添加额外引用根据你的需求可以添加以下模块模块功能用途HeBianGu.Control.Message消息提示、对话框显示 Snackbar、弹窗HeBianGu.Window.MessageDialog对话框窗口显示确认对话框HeBianGu.Service.Animation动画服务页面转场动画HeBianGu.Systems.Setting系统设置应用配置管理HeBianGu.Control.PropertyGrid属性面板对象属性编辑HeBianGu.Control.PagedDataGrid分页表格数据列表展示修改 App.xaml 替换内容将App.xaml的内容替换为以下代码h:ApplicationBasex:ClassMyFirstApp.Appxmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentationxmlns:xhttp://schemas.microsoft.com/winfx/2006/xamlxmlns:hhttps://github.com/HeBianGu/h:ApplicationBase 代码说明部分说明h:ApplicationBase继承框架的应用基类xmlns:hhttps://github.com/HeBianGu引入框架命名空间x:ClassMyFirstApp.App指定代码隐藏文件修改 App.xaml.cs 替换内容将App.xaml.cs的内容替换为以下代码usingHeBianGu.General.WpfControlLib;usingMicrosoft.Extensions.DependencyInjection;usingMicrosoft.Extensions.Hosting;usingSystem.Windows;namespaceMyFirstApp{publicpartialclassApp:ApplicationBase{/// summary/// 创建主窗口/// /summaryprotectedoverrideMainWindowBaseCreateMainWindow(StartupEventArgse){returnnewMainWindow();}/// summary/// 配置服务依赖注入/// /summaryprotectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);// 添加窗口动画服务services.AddWindowAnimation();// 添加消息代理服务Snackbar 等services.AddMessageProxy();// 添加对话框服务services.AddWindowDialog();// 添加系统设置服务可选services.AddSetting();}/// summary/// 配置应用/// /summaryprotectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);// 配置本地主题app.UseLocalTheme(x{// 设置主题类型Light浅色、Dark深色x.ThemeTypeThemeType.Light;// 设置语言Chinese中文、English英文x.LanguageLanguage.Chinese;});}}} 代码说明1. CreateMainWindow 方法protectedoverrideMainWindowBaseCreateMainWindow(StartupEventArgse){returnnewMainWindow();}这个方法告诉框架启动时显示哪个窗口。2. ConfigureServices 方法protectedoverridevoidConfigureServices(IServiceCollectionservices){base.ConfigureServices(services);// 注册各种服务services.AddWindowAnimation();services.AddMessageProxy();services.AddWindowDialog();}这个方法用于注册依赖注入服务服务功能AddWindowAnimation()注册窗口转场动画服务AddMessageProxy()注册消息代理服务SnackbarAddWindowDialog()注册对话框服务AddSetting()注册系统设置服务3. Configure 方法protectedoverridevoidConfigure(IApplicationBuilderapp){base.Configure(app);app.UseLocalTheme(x{x.ThemeTypeThemeType.Light;x.LanguageLanguage.Chinese;});}这个方法用于配置应用配置项说明ThemeType主题类型可选Light或DarkLanguage语言可选Chinese或English创建主窗口 修改 MainWindow.xaml将MainWindow.xaml的内容替换为以下代码h:MainWindowBasex:ClassMyFirstApp.MainWindowxmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentationxmlns:xhttp://schemas.microsoft.com/winfx/2006/xamlxmlns:hhttps://github.com/HeBianGuTitle我的第一个应用Height600Width800!-- 主内容区域 --Grid!-- 使用网格布局 --Grid.RowDefinitionsRowDefinitionHeightAuto/RowDefinitionHeight*/RowDefinitionHeightAuto//Grid.RowDefinitions!-- 工具栏 --StackPanelGrid.Row0OrientationHorizontalMargin10ButtonContent显示消息Command{Binding ShowMessageCommand}Margin5Padding10,5/ButtonContent显示对话框Command{Binding ShowDialogCommand}Margin5Padding10,5/ButtonContent显示设置Command{Binding ShowSettingsCommand}Margin5Padding10,5//StackPanel!-- 主内容 --BorderGrid.Row1BackgroundWhiteMargin10StackPanelHorizontalAlignmentCenterVerticalAlignmentCenterTextBlockText欢迎使用 WPF-ControlBase 框架FontSize24Margin0,0,0,20/TextBlockText这是您的第一个应用程序FontSize16Foreground#666//StackPanel/Border!-- 状态栏 --StatusBarGrid.Row2StatusBarItemTextBlockText就绪//StatusBarItem/StatusBar/Grid/h:MainWindowBase 修改 MainWindow.xaml.cs将MainWindow.xaml.cs的内容替换为以下代码usingHeBianGu.General.WpfControlLib;usingHeBianGu.Systems.Setting;usingHeBianGu.Window.Main;usingSystem.Windows;namespaceMyFirstApp{publicpartialclassMainWindow:MainWindowBase{publicMainWindow(){InitializeComponent();// 设置数据上下文DataContextnewMainViewModel();}}publicclassMainViewModel:NotifyPropertyChangedBase{/// summary/// 显示消息命令/// /summarypublicICommandShowMessageCommandnewRelayCommand((){// 使用消息代理显示 Snackbar 消息MessageProxy.Snacker.ShowTime(这是一条提示消息);});/// summary/// 显示对话框命令/// /summarypublicICommandShowDialogCommandnewRelayCommand((){// 显示确认对话框boolresultMessageDialogWindow.ShowSumit(确定要执行此操作吗,确认);if(result){MessageProxy.Snacker.ShowTime(用户点击了确定);}else{MessageProxy.Snacker.ShowTime(用户点击了取消);}});/// summary/// 显示设置命令/// /summarypublicICommandShowSettingsCommandnewRelayCommand((){// 显示设置对话框vardialognewSettingDialog();dialog.ShowDialog();});}} 代码说明1. MainWindow 类publicpartialclassMainWindow:MainWindowBase{publicMainWindow(){InitializeComponent();DataContextnewMainViewModel();}}继承MainWindowBase获得框架提供的窗口功能包括统一的标题栏样式窗口动画效果消息提示能力2. MainViewModel 类publicclassMainViewModel:NotifyPropertyChangedBase{publicICommandShowMessageCommandnewRelayCommand((){MessageProxy.Snacker.ShowTime(这是一条提示消息);});}继承NotifyPropertyChangedBase获得属性变更通知能力实现 MVVM 模式。运行应用▶️ 步骤1设置启动项目在解决方案资源管理器中右键点击你的项目选择 “设为启动项目”▶️ 步骤2运行点击工具栏上的 “启动” 按钮绿色三角形或者按 F5 键✅ 预期结果应用启动显示主窗口点击 “显示消息” 按钮底部弹出 Snackbar 消息点击 “显示对话框” 按钮弹出确认对话框点击 “显示设置” 按钮弹出设置对话框使用模板项目推荐如果你觉得以上步骤太繁琐可以直接使用模板项目 模板位置Source/Template/HeBianGu.Template.Main 使用步骤复制模板项目文件夹到你的工作目录重命名文件夹为你的项目名称打开解决方案修改命名空间根据需求添加或删除功能 模板项目结构HeBianGu.Template.Main/ ├── App.xaml # 应用入口 ├── App.xaml.cs # 应用配置 ├── MainWindow.xaml # 主窗口 ├── MainWindow.xaml.cs # 主窗口代码 ├── ViewModels/ # 视图模型 │ └── MainViewModel.cs ├── Views/ # 视图可选 └── Properties/ └── AssemblyInfo.cs常见问题❌ 问题1找不到命名空间错误信息The name h does not exist in the current context解决方案确保已正确引用HeBianGu.General.WpfControlLib项目检查 XAML 中的命名空间是否正确xmlns:hhttps://github.com/HeBianGu清理并重新生成解决方案❌ 问题2MainWindowBase 找不到错误信息The type or namespace name MainWindowBase could not be found解决方案确保引用了HeBianGu.General.WpfControlLib添加 using 语句using HeBianGu.General.WpfControlLib;检查项目目标框架是否为.NET 7.0 Windows❌ 问题3服务注册报错错误信息IServiceCollection does not contain a definition for AddWindowAnimation解决方案确保引用了HeBianGu.Service.Animation添加 using 语句using HeBianGu.Service.Animation;检查框架版本是否正确❌ 问题4运行时崩溃错误信息应用启动后立即崩溃解决方案检查App.xaml.cs中的配置是否正确确保所有服务都已正确注册检查主窗口是否正确继承MainWindowBase使用调试模式运行查看具体错误信息扩展学习 推荐学习路径基础篇了解 MVVM 模式、依赖注入控件篇学习框架提供的各种控件服务篇学习消息、动画、设置等服务进阶篇学习 MVC/MVP 架构、数据库访问 推荐示例项目示例路径学习重点图表示例Source/Demo/HeBianGu.App.Chart数据可视化属性面板示例Source/Demo/HeBianGu.App.PropertyGrid属性编辑MVC 示例Source/Demo/HeBianGu.App.Mvc导航架构总结通过以上步骤你已经成功创建了第一个基于 WPF-ControlBase 框架的应用 关键要点继承框架基类App继承ApplicationBaseMainWindow继承MainWindowBase注册服务在ConfigureServices中注册所需服务配置应用在Configure中配置主题和语言使用消息服务通过MessageProxy显示消息和对话框 下一步添加更多页面和功能学习使用各种控件连接数据库发布应用、