在.NET应用程序开发中，程序集是代码的基本部署单元，为程序集添加清晰的描述信息可以方便后续的项目维护和团队协作。AssemblyDescriptionAttribute是.NET提供的一个特性类，专门用于为程序集设置描述文本，我们可以在项目的特性配置中直接使用它来添加自定义的描述内容。
AssemblyDescriptionAttribute的基本概念
AssemblyDescriptionAttribute位于System.Reflection命名空间下，它是一个程序集级别的特性，允许我们为当前程序集指定一段文本描述。这段描述信息会被编译到程序集的元数据当中，后续可以通过反射的方式读取，也会在一些工具中展示出来，比如Windows的文件属性详情页。
不同项目类型中的配置方式
.NET Framework项目配置
在传统的.NET Framework项目中，通常会在项目的Properties文件夹下找到AssemblyInfo.cs文件，我们可以直接在这个文件中添加AssemblyDescriptionAttribute特性来设置描述信息。
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
// 设置程序集的描述信息
[assembly: AssemblyDescription("这是一个用于用户管理的通用工具类库，提供了用户增删改查的基础功能")]
[assembly: AssemblyTitle("UserManagementTool")]
[assembly: AssemblyCompany("TestCompany")]
[assembly: AssemblyVersion("1.0.0.0")]
如果希望动态修改描述内容，也可以不在AssemblyInfo.cs中硬编码，而是在项目属性页的“应用程序”选项卡的“程序集信息”弹窗中填写描述字段，IDE会自动将内容同步到特性配置中。
.NET Core及更高版本项目配置
在.NET Core、.NET 5及之后的版本中，项目默认不再生成AssemblyInfo.cs文件，相关的程序集特性配置可以直接写在项目文件（.csproj）中，通过PropertyGroup节点下的属性来设置。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Library</OutputType>
<TargetFramework>net8.0</TargetFramework>
<!-- 设置程序集描述信息 -->
<AssemblyDescription>这是一个用于订单处理的通用类库，支持订单创建、状态更新和查询功能</AssemblyDescription>
<AssemblyTitle>OrderProcessLib</AssemblyTitle>
<Version>2.1.0</Version>
</PropertyGroup>
</Project>
如果需要使用特性方式配置，也可以手动在项目根目录创建AssemblyInfo.cs文件，然后添加对应的特性，同时需要在项目文件中设置
读取程序集描述信息的方法
添加完描述信息后，我们可以通过反射的方式读取程序集的描述内容，示例代码如下：
using System;
using System.Reflection;
class Program
{
static void Main()
{
// 获取当前正在运行的程序集
Assembly currentAssembly = Assembly.GetExecutingAssembly();
// 获取程序集上的AssemblyDescriptionAttribute特性
AssemblyDescriptionAttribute descriptionAttr = currentAssembly.GetCustomAttribute<AssemblyDescriptionAttribute>();
if (descriptionAttr != null)
{
Console.WriteLine($"程序集描述信息：{descriptionAttr.Description}");
}
else
{
Console.WriteLine("未找到程序集描述信息");
}
}
}
注意事项
- 描述信息的内容建议简洁明确，能够准确反映程序集的核心功能，避免填写无关内容。
- 如果同时使用了项目文件配置和特性配置，项目文件中的配置优先级更高，会覆盖特性中设置的内容。
- 描述信息支持中文和特殊字符，但建议尽量使用通用的文本格式，避免出现编码问题。
AssemblyDescriptionAttribute.NET程序集描述特性配置修改时间：2026-07-05 01:33:11