从文档注释生成 XML

要从代码中的文档注释生成 XML 文档文件，请将/doc 选项与 csc.exe C#编译器一起使用。

在 Visual Studio 2013/2015 的“ 项目 - > 属性 - > 构建 - > 输出”中，选中 XML documentation file 复选框：

在构建项目时，编译器将生成一个 XML 文件，其名称对应于项目名称（例如 XMLDocumentation.dll - > XMLDocumentation.xml）。

在另一个项目中使用程序集时，请确保 XML 文件与正在引用的 DLL 位于同一目录中。

这个例子：

/// <summary>
/// Data class description
/// </summary>
public class DataClass
{
    /// <summary>
    /// Name property description
    /// </summary>
    public string Name { get; set; }
}

/// <summary>
/// Foo function
/// </summary>
public class Foo
{
    /// <summary>
    /// This method returning some data
    /// </summary>
    /// <param name="id">Id parameter</param>
    /// <param name="time">Time parameter</param>
    /// <returns>Data will be returned</returns>
    public DataClass GetData(int id, DateTime time)
    {
        return new DataClass();
    }
}

在 build 上生成这个 xml：

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>XMLDocumentation</name>
    </assembly>
    <members>
        <member name="T:XMLDocumentation.DataClass">
            <summary>
            Data class description
            </summary>
        </member>
        <member name="P:XMLDocumentation.DataClass.Name">
            <summary>
            Name property description
            </summary>
        </member>
        <member name="T:XMLDocumentation.Foo">
            <summary>
            Foo function
            </summary>
        </member>
        <member name="M:XMLDocumentation.Foo.GetData(System.Int32,System.DateTime)">
            <summary>
            This method returning some data
            </summary>
            <param name="id">Id parameter</param>
            <param name="time">Time parameter</param>
            <returns>Data will be returned</returns>
        </member>
    </members>
</doc>