.NET程序集文件附带的XML文件是什么？

许多.NET程序集都附带一个XML文件。例如System.Web.WebPages.Razor.dll与System.Web.WebPages.Razor.xml一起包含以下内容：

<?xml version="1.0" encoding="utf-8" ?> 
<doc>
   <assembly>
       <name>System.Web.WebPages.Razor</name> 
   </assembly>
   <members>
       <member name="T:System.Web.WebPages.Razor.PreApplicationStartCode" /> 
       <member name="M:System.Web.WebPages.Razor.PreApplicationStartCode.Start" /> 
       <member name="T:System.Web.WebPages.Razor.RazorBuildProvider" /> 
       <member name="M:System.Web.WebPages.Razor.RazorBuildProvider.#ctor" />
        Much more elements follow...
   </members>
</doc>

这是什么XML？我在运行时需要它吗？

它是代码注释/智能感知文件，由IDE(即Visual Studio)使用，而不是运行时 – 它是所有扩展方法/参数/类型描述等来自的地方。

你不需要用二进制文件来部署它，但是它也没有任何危害。它在IDE中也是完全可选的 – 只是：如果没有它，智能感知将会更少的信息(它将只显示名称和类型等，而不是更详细的方法描述)。

在您自己的库中，使用///语法编写自己的代码注释，并在项目属性中启用XML文件生成。