在 .NET 8 开发的WinForms 程序中展示程序版本号的几种方式
前言
欢迎关注dotnet研习社，今天我们讨论一个Winform开发中的一个常见的需求内容“关于程序的版本号显示”。
在 WinForms 桌面应用程序开发中，向用户显示当前程序的版本号是一个常见的需求，尤其是在产品发布、更新提示或技术支持场景中尤为重要。在.NET 8 中已全面采用 SDK 风格项目，相比旧的 .NET Framework 项目，版本号的设置和读取方式更加规范和现代化。本文将介绍在 WinForms 应用中显示程序版本号的几种常见方式，并附上示例代码，供大家参考和选择。
☑ 项目准备
确保我们的 .csproj 是 SDK 风格，并配置版本号：
<Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"><PropertyGroup><OutputType>WinExe</OutputType><TargetFramework>net8.0-windows</TargetFramework><UseWindowsForms>true</UseWindowsForms><!-- 版本信息设置 --><Version>1.2.3</Version><FileVersion>1.2.3.0</FileVersion><AssemblyVersion>1.2.0.0</AssemblyVersion><InformationalVersion>1.2.3-beta</InformationalVersion></PropertyGroup></Project>
✅ 示例 1：窗体标题栏显示版本号（使用 Application.ProductVersion）
示例代码：
public partial class MainForm : Form
{public MainForm(){InitializeComponent();this.Text = $"我的程序 - 版本 {Application.ProductVersion}";}
}
说明：
- 输出示例：
我的程序 - 版本 1.2.3-beta - 适用于：简洁快速展示，适合主界面。
✅ 示例 2：Label 中显示版本号（使用 AssemblyVersion）
示例代码：
using System.Reflection;public partial class MainForm : Form
{public MainForm(){InitializeComponent();var version = Assembly.GetExecutingAssembly().GetName().Version;Label lblVersion = new Label{Text = $"程序集版本：{version}",AutoSize = true,Location = new Point(20, 20)};this.Controls.Add(lblVersion);}
}
说明：
- 输出示例：
程序集版本：1.2.0.0 - 适用于：开发或内部测试查看版本绑定。
✅ 示例 3：状态栏中显示版本号（使用 FileVersionInfo）
示例代码：
在窗体中添加了 StatusStrip 和 ToolStripStatusLabel 控件，命名为 statusStrip1 和 toolStripStatusLabel1。
using System.Diagnostics;public partial class MainForm : Form
{public MainForm(){InitializeComponent();var info = FileVersionInfo.GetVersionInfo(Application.ExecutablePath);toolStripStatusLabel1.Text = $"文件版本：{info.FileVersion}";}
}
说明：
- 输出示例：
文件版本：1.2.3.0 - 适用于：状态栏、底部信息区。
✅ 示例 4：AboutBox 显示版本号（使用 Application.ProductVersion）
添加步骤：
在窗体中添加了 menuStrip 和 toolStripMenuItem 控件，命名为 menuStrip1 和 toolStripMenuItem1。
- 添加 → 新建项 → “关于框（About Box）”
- 在
AboutBox1.cs修改版本号设置：
partial class AboutBox1 : Form
{public AboutBox1(){InitializeComponent();this.Text = String.Format("关于 {0}", AssemblyTitle);this.labelProductName.Text = AssemblyProduct;this.labelVersion.Text = String.Format("版本 {0}", AssemblyVersion);this.labelCopyright.Text = AssemblyCopyright;this.labelCompanyName.Text = AssemblyCompany;this.textBoxDescription.Text = AssemblyDescription;}#region 程序集特性访问器public string AssemblyTitle{get{object[] attributes = Assembly.GetExecutingAssembly().GetCustomAttributes(typeof(AssemblyTitleAttribute), false);if (attributes.Length > 0){AssemblyTitleAttribute titleAttribute = (AssemblyTitleAttribute)attributes[0];if (titleAttribute.Title != ""){return titleAttribute.Title;}}return System.IO.Path.GetFileNameWithoutExtension(Assembly.GetExecutingAssembly().CodeBase);}}public string AssemblyVersion{get{return Assembly.GetExecutingAssembly().GetName().Version.ToString();}}public string AssemblyDescription{get{object[] attributes = Assembly.GetExecutingAssembly().GetCustomAttributes(typeof(AssemblyDescriptionAttribute), false);if (attributes.Length == 0){return "";}return ((AssemblyDescriptionAttribute)attributes[0]).Description;}}public string AssemblyProduct{get{object[] attributes = Assembly.GetExecutingAssembly().GetCustomAttributes(typeof(AssemblyProductAttribute), false);if (attributes.Length == 0){return "";}return ((AssemblyProductAttribute)attributes[0]).Product;}}public string AssemblyCopyright{get{object[] attributes = Assembly.GetExecutingAssembly().GetCustomAttributes(typeof(AssemblyCopyrightAttribute), false);if (attributes.Length == 0){return "";}return ((AssemblyCopyrightAttribute)attributes[0]).Copyright;}}public string AssemblyCompany{get{object[] attributes = Assembly.GetExecutingAssembly().GetCustomAttributes(typeof(AssemblyCompanyAttribute), false);if (attributes.Length == 0){return "";}return ((AssemblyCompanyAttribute)attributes[0]).Company;}}#endregion
}
- 调用方式：
private void toolStripMenuItem1_Click(object sender, EventArgs e)
{new AboutBox1().ShowDialog();
}
✅ 示例 5：读取外部版本文件（CI 自动生成 version.txt）
准备版本文件：
项目发布后输出目录含有 version.txt 内容如：
1.2.3+build.12345
示例代码：
public partial class MainForm : Form
{public MainForm(){InitializeComponent();string versionFile = Path.Combine(AppContext.BaseDirectory, "version.txt");string buildVersion = File.Exists(versionFile) ? File.ReadAllText(versionFile).Trim() : "Unknown";Label lbl = new Label{Text = $"构建版本：{buildVersion}",AutoSize = true,Location = new Point(20, 50)};this.Controls.Add(lbl);}
}
✅ 示例 6：统一封装 VersionHelper 工具类
using System.Reflection;
using System.Diagnostics;public static class VersionHelper
{public static string AssemblyVersion =>Assembly.GetExecutingAssembly().GetName().Version?.ToString() ?? "Unknown";public static string FileVersion =>FileVersionInfo.GetVersionInfo(Application.ExecutablePath).FileVersion ?? "Unknown";public static string ProductVersion =>Application.ProductVersion ?? "Unknown";
}
调用方式：
Label lbl = new Label
{Text = $"程序集版本：{VersionHelper.AssemblyVersion}\n文件版本：{VersionHelper.FileVersion}",AutoSize = true,Location = new Point(20, 80)
};
this.Controls.Add(lbl);
对比总结
| 方式编号 | 获取方式 | 来源（csproj 或程序集） | 示例输出 | 推荐用途 | 特点说明 |
|---|---|---|---|---|---|
| ① | Application.ProductVersion | <InformationalVersion>（或 <Version>） | 1.2.3-beta | UI显示（标题栏、关于框、Label） | 默认最直观，获取产品版本，强烈推荐 |
| ② | Assembly.GetExecutingAssembly().GetName().Version | <AssemblyVersion> | 1.2.0.0 | 内部模块依赖、调试 | 获取程序集绑定版本，不一定展示给用户 |
| ③ | FileVersionInfo.FileVersion | <FileVersion> | 1.2.3.0 | 状态栏、日志、故障排查 | Windows 文件属性中可见的“文件版本” |
| ④ | FileVersionInfo.ProductVersion | <InformationalVersion>（或 <Version>） | 1.2.3-beta | 技术支持、版本详情 | 和 Application.ProductVersion 一致 |
| ⑤ | 读取 version.txt、嵌入资源等 | CI/CD 或 Git 自动生成 | 1.2.3+g123abc | 内部构建版本控制 | 灵活但需配合构建脚本或 CI 工具 |
| ⑥ | 自定义 AboutBox 显示 | 可组合 ①~⑤ | 自由定制 | 标准“关于”窗口 | 常用于商业软件，集中展示版本、版权等 |
🎯 推荐选择指南
- 开发初期快速显示：使用
Application.ProductVersion - 需要对比程序集版本绑定：使用
AssemblyVersion - 需要展示文件详细版本（如系统托盘右键）：使用
FileVersionInfo - 需要区分构建版本（多环境发布）：结合 CI 写入
version.txt - 面向最终用户展示：统一写入 AboutBox，使用封装工具类读取版本