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

Question

注意：这是this 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

在VS2012中好像不能做这个事情，但是在VS2013中已经修复了；你可以直接写<see cref="FancyClass(Of T)" />。

Answer 2

我习惯写这样的东西：

''' <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)：这不是一个类。