是否可以在摘要注释中包含c#定义?

时间:2011-05-02 16:02:23

标签: c# comments

是否可以在摘要注释中使用c#定义? 而不是对象列表

/// <summary>
/// Gets a List of Objects given a Table ID
/// </summary>
/// <param name="p_Table">The Table name to search for</param>
/// <param name="p_Id">The ID field within the p_Table to search for</param>
/// <param name="ObjectList">A List of Objects as an out parameter</param>
/// <returns>A List of Objects</returns>

我想在摘要

中专门使用 List<Object>
/// <summary>
/// Gets a List<Objects> given a Table ID
/// </summary>
/// <param name="p_Table">The Table name to search for</param>
/// <param name="p_Id">The ID field within the p_Table to search for</param>
/// <param name="ObjectList">A List<Objects> as an out parameter</param>
/// <returns>A List<Objects></returns>

1 个答案:

答案 0 :(得分:6)

如果您不想使用<see cref=""/>表示法创建链接,则必须转义尖括号,如下所示:

/// <returns>A List&lt;Objects&gt;</returns>

毕竟,它仍然是XML。

但是,如果您想使用<see cref=""/>表示法进行引用,则无法指定特定的类型参数(在本例中为Objects),但您可以{{3像这样:

/// <returns>A <see cref="List{T}" /></returns>

这将在文档中创建指向List<T>的链接。很遗憾,你无法取代T; XML文档不支持(但希望将来能够支持)。