1

在 C# xml 注释中,下面的标签有什么区别?

1. <c> 
2. <code>
4

3 回答 3

5

假设您正在谈论xml 注释中的标签c就像 StackOverflow 中的反引号,而code更像是代码块。

/// <summary>
/// This is the <c>SomeMethod</c> method of the <c>Program</c> class.
/// </summary>
/// <param name="s">A string.</param>
/// <example>
/// You can use this method like this:
/// <code>
/// string x = SomeMethod("foobar");
/// Console.WriteLine(x);
/// </code>
/// </example>
static string SomeMethod(string s){
    throw new NotImplementedException();
} 
于 2011-10-31T13:10:53.230 回答
3
<c>Your code sample.</c>    

表示一小段代码。您将使用 c 标签来引起对生成文档中特定单词、短语或代码的注意。您将 c 标签嵌套在其他标签中。

<code>Your code sample.</code>  

代码标签类似于标签,但它旨在说明一个真实的代码使用示例。代码标签通常包含在标签集中(见下文)。

于 2011-10-31T13:09:16.617 回答
3

如果您的意思是在代码注释中,则<code>(通常在 中使用<example>)表示多行说明性代码,其中<c>-as 仅表示要以代码字体编写的单个术语。

使用 stackoverflow/markdown 作为比较,它们与inline code段落中间的完全一样,vs

a multi-line
code sample that
appears formatted separately
于 2011-10-31T13:09:23.810 回答