c# - 如何在 C# XML 文档中标记代码

Question

我有这个功能：

public static string Join(this IEnumerable<string> strings, string separator)
{
    return string.Join(separator, strings.ToArray());
}

我要记录的。
我想让<return>标签告诉string.Join(separator, strings.ToArray())任何能够阅读 C# 代码的人，这会说一千多个单词。但是，当我使用

<return>string.Join(separator, strings.ToArray())</return>

然后 string.Join(separator, strings.ToArray()) 将被格式化为纯文本，这使得它几乎不可读。所以我尝试了

<return><code>string.Join(separator, strings.ToArray())</code></return>

但这总是会创建一个新段落...

所以这是我的问题：
有没有办法格式化一段文本，让它看起来好像是代码？我会对固定宽度的字体感到满意。

score 8 · Accepted Answer

<c> 标签听起来就是您要查找的内容。查看 MSDN 的标签参考以获取更多详细信息。

也就是说，您确定要让文档直接引用该函数执行的操作吗？如果您决定稍后更改实现怎么办？我知道这是一个非常微不足道的例子，但值得深思！:)

1 回答 1