如何在智能感知中显示自定义 ToString() 格式？

Question

我想在智能感知中显示自定义 ToString() 格式，例如下面的DateTime.ToString()。

下面是示例代码，当有人键入 myObject.ToString("") 时，我想在智能感知中显示“a”或“b”。

public class MyClass : IFormattable
{
    public string ToString(string format, IFormatProvider formatProvider)
    {
        switch (format)
        {
            case "a":
                return "A";
            case "b":
                return "B";
            default:
                return "A";
        }
    }
}

Answer 1

您可以为此使用XML Doc Comments。

例如，对于您的ToString()，类似以下内容：

public class MyClass : IFormattable
{
    /// <summary>Converts this to a formatted string.</summary>
    /// <param name="format">
    ///   A format string. This may have the following values:
    ///   <list type="table">
    ///     <listheader>
    ///       <term>Format strings</term>
    ///     </listheader>
    ///     <item>
    ///       <term>"a"</term>
    ///       <description>Format using "a"</description>
    ///     </item>
    ///     <item>
    ///       <term>"b"</term>
    ///       <description>Format using "b"</description>
    ///     </item>
    ///   </list>
    /// </param>
    /// <param name="formatProvider">A format provider.</param>
    /// <returns>The formatted string.</returns>

    public string ToString(string format, IFormatProvider formatProvider)
    {
        switch (format)
        {
            case "a":
                return "A";
            case "b":
                return "B";
            default:
                return "A";
        }
    }
}