Visual Studio 项目属性页开发完全教程：从基础到高级-CSDN博客

Visual Studio 项目属性页开发完全教程：从基础到高级

【免费下载链接】project-system The .NET Project System for Visual Studio 项目地址: https://gitcode.com/gh_mirrors/pr/project-system

Visual Studio 项目属性页是开发者管理项目配置的核心界面，通过 .NET Project System 可以轻松创建和扩展自定义属性页。本教程将带你从基础到高级，掌握 Visual Studio 项目属性页的设计与开发技巧，让项目配置更高效、更个性化！

项目属性页基础：认识核心组件 📊

项目属性页是通过 Rule 类定义的动态界面，它负责将 UI 控件与项目文件配置绑定。在 Visual Studio 中，你可以通过右键项目 → 属性打开标准属性页，如应用程序设置、生成选项等。

图 1：Visual Studio 应用程序属性页界面，包含程序集名称、目标框架等核心配置项

核心概念解析

Rule 类：定义属性页结构的基础，通过 XAML 或代码描述 UI 布局与数据绑定
PropertyPageSchema：MSBuild 项用于指定属性页文件路径，使 Visual Studio 能识别自定义页面
MEF 导出：通过 IRuleObjectProvider 在代码中动态提供属性页定义（VS 2022+ 支持）

快速上手：创建你的第一个属性页 ⚡

准备工作

克隆项目仓库：git clone https://gitcode.com/gh_mirrors/pr/project-system
参考官方文档：docs/repo/property-pages/how-to-add-a-new-project-property-page.md

步骤 1：创建 XAML 定义文件

在项目中添加 MyPropertyPage.xaml，定义属性页的基本结构：

<?xml version="1.0" encoding="utf-8" ?>
<Rule Name="MyPropertyPage"
      DisplayName="My Properties"
      PageTemplate="generic"
      xmlns="http://schemas.microsoft.com/build/2009/properties">
  <Rule.DataSource>
    <DataSource Persistence="ProjectFile" HasConfigurationCondition="False" />
  </Rule.DataSource>
  <StringProperty Name="MyProperty" 
                  DisplayName="My property" 
                  Description="A property that writes to the project file." />
</Rule>

步骤 2：配置项目文件

在 .props 或 .targets 文件中添加 PropertyPageSchema 项：

<PropertyPageSchema Include="path\to\MyPropertyPage.xaml">
  <Context>Project</Context>
</PropertyPageSchema>

步骤 3：查看效果

构建项目后，在 Visual Studio 中打开项目属性，即可看到新创建的 "My Properties" 页面：

图 2：自定义属性页示例，包含一个简单的文本输入框

高级技巧：扩展现有属性页 🔧

有时你不需要创建全新页面，而是希望在标准属性页（如 "应用程序"）中添加自定义属性。通过 OverrideMode="Extend" 可以轻松实现：

扩展应用程序属性页示例

创建 MyExtendedApplicationPage.xaml：

<Rule Name="Application" OverrideMode="Extend" xmlns="http://schemas.microsoft.com/build/2009/properties">
  <StringProperty Name="MyExtensionProperty" 
                  DisplayName="My extension property" 
                  Description="An extension property that writes to the project file." />
</Rule>

扩展后的效果如下：

图 3：扩展后的应用程序属性页，新增了自定义扩展属性