c# - XML 注释 - 智能感知中未显示的异常

Question

我在命名空间下有一个抛出异常的方法:MyApp.Domain。我在命名空间下有一些自定义异常:MyApp.Domain.Exceptions。所以我所拥有的是:

using MyApp.Domain.Exceptions
using System;

namespace MyApp.Domain
{
    public class SomeClass
    {
        ///<summary>This method does some stuff</summary>
        ///<exception cref="MyCustomExeption">MyCustomException if x</exception>
        ///<exception cref="Exception">GenericException if y</exception>
        public void DoStuff(){

            //Does stuff

        }
    }
}

我正在使用智能感知获取我的摘要，但没有异常(exception)。我是否必须使用 include 并创建外部 xml 注释文件，因为它们位于不同的命名空间下？这两个异常都没有出现在智能感知、mycustomexception 或 system.exception 中。

谢谢。

Answer 1

实际上是Exception一旦您键入完整的方法名称，然后将鼠标悬停在上面，标签就会可见。

如果您想在开始输入方法名称时立即显示异常，您必须在摘要标记中提供异常，用 <para> 分隔

     /// <summary>
    /// this is my method for date convert        
    /// <para>Exception:</para>
    /// Exception - this will appear as soon as you started typing the method name and method over.
    /// </summary>
    /// <exception cref="Exception"></exception> 

希望它清楚你想要什么。

在用户开始输入方法名称时立即显示您想要的任何内容。您只需在摘要标签内提供。