從文件註釋生成 XML

要從程式碼中的文件註釋生成 XML 文件檔案,請將/doc 選項與 csc.exe C#編譯器一起使用。

在 Visual Studio 2013/2015 的“ 專案 - > 屬性 - > 構建 - > 輸出”中,選中 XML documentation file 核取方塊:

StackOverflow 文件

在構建專案時,編譯器將生成一個 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>