c# - 覆盖时保留注释

Question

有没有一种方法(工具或其他东西)允许在从基类继承/覆盖方法时不重复相同的 XML 注释？

例如:

/// <summary>
/// Represent a brand new object in .NET
/// </summary>
public class MyObject : Object
{
    /// <summary>
    /// Copy-Paste the same Xml comment 
    /// like in the base class is boring!
    /// </summary>
    /// <param name="obj">and params too!! ((</param>
    /// <returns>this one too!!! (((</returns>
    public override bool Equals(object obj)
    {
        return base.Equals(obj);
    }
}

Answer 1

我认为您正在寻找 inheritdoc:

/// <inheritdoc />
public override bool Equals(object obj)

这不是 standard tag (因此 Intellisense 可能不支持它，例如)，但它很常用 - 特别是 Sandcastle supports it .