在Visual Studio中为C#项目创建自定义UI属性页

问题场景 #

我已经在C#项目的.csproj文件中添加了以下自定义属性：

<PropertyGroup>
  <PropEnabler>True</PropEnabler>
  <PropValue>C:\SomeDir\...\SomeFile.ini</PropValue>
</PropertyGroup>

希望为该项目创建如图所示的自定义UI属性页（自定义属性页示例）。尝试适配C++项目(.vcxproj)的自定义属性页教程失败，求有效方案或思路。

可行解决路径 #

1. 开发VSIX扩展+项目属性页插件 #

这是官方支持的标准实现方式，步骤如下：

• 新建VSIX扩展项目，添加「项目属性页」模板项
• 使用WPF或WinForms制作属性页UI，将控件与.csproj中的自定义属性绑定：
  • 通过IVsBuildPropertyStorage接口读取/写入PropEnabler和PropValue属性值
  • 比如让复选框对应PropEnabler的布尔状态，文件选择框对应PropValue的路径值
• 注意适配目标Visual Studio版本（如2019/2022）的框架要求，避免扩展加载失败

2. 利用MSBuild Schema实现简化属性页 #

如果不需要复杂交互，这个方案更轻量化：

• 在项目中创建.xml格式的属性页配置文件（Schema文件），定义属性的展示规则：

  <PropertyPageSchema xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Page Name="自定义属性" DisplayName="自定义属性" Description="配置项目自定义属性">
      <Category Name="基础配置" DisplayName="基础配置">
        <Property Name="PropEnabler" DisplayName="启用自定义属性" Description="开关自定义属性逻辑" Type="bool" />
        <Property Name="PropValue" DisplayName="配置文件路径" Description="指定配置文件的路径" Type="file" />
      </Category>
    </Page>
  </PropertyPageSchema>
  

• 在.csproj中引用该Schema文件：

  <ItemGroup>
    <PropertyPageSchema Include="你的Schema文件路径" />
  </ItemGroup>
  

VS会自动识别并生成对应的属性页，无需额外编写UI代码

3. 第三方工具临时编辑（不推荐集成） #

可以用MSBuild Editor这类工具临时修改属性，但无法集成到VS的属性页体系中，仅适合临时操作

避坑提醒 #

• 不要硬套C++项目方案：.vcxproj基于VCProjectEngine，.csproj基于通用MSBuild项目系统，二者API与扩展机制完全不同
• 测试时建议以管理员身份启动VS，避免扩展加载或属性写入的权限问题
• VS2022的扩展需适配.NET 6及以上框架，且要正确选择目标VS版本

内容的提问来源于stack exchange，提问作者Jark