VB.NET:如何在xml文档中引用泛型类和方法

Question

注意:这是此问题的副本,但对于Visual Basic而不是C#.

编写可以使用的XML文档时<see cref="something">something</see>,当然可以使用.但是,如何引用具有泛型类型的类或方法？

Public Class FancyClass(Of T)

  Public Function  FancyMethod(value As T) As String
    Return "something fancy"
  End Function

End Class

如果我要在某处写xml文档,我将如何引用这个花哨的类？我该如何参考FancyClass(Of String)？方法怎么样？

例如,在另一个类中,我想让用户知道我将返回一个实例FancyClass(Of Integer).我怎么能see cref为此做点什么呢？

Answer 1

我习惯写这样的东西：

''' <summary>
''' A great fancy class.
''' </summary>
''' <typeparam name="T">Generic stuff ....</typeparam>
Public Class FancyClass(Of T)

    ''' <summary>
    ''' A fancy method that do fancy operation.
    ''' </summary>
    ''' <param name="value">The value.</param>
    ''' <returns></returns>
    Public Function FancyMethod(value As T) As String
        Return "something fancy"
    End Function

End Class

xml 文档必须讨论您的通用类。你永远不会引用FancyClass(Of String)：这不是一个类。