C#

时间:2019-02-02 20:49:26

标签: c# comments xml-comments

在C#代码中询问文档注释的约定时,答案总是导致使用XML注释。微软建议使用此方法本身以及。 https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/recommended-tags-for-documentation-comments

/// <summary>
/// This is an XML comment.
/// </summary>
void Foo();

然而,检查微软的代码,如ASP.NET核心的时候,而不是评论是这样的。

//
// Summary:
//     A builder for Microsoft.AspNetCore.Hosting.IWebHost.
public interface IWebHostBuilder

是否与本公约所包含的文档生成工具的工作,或者是有一个文档生成工具,采用了这种约定,而不是XML?为什么微软在他们的代码中使用这种约定,而不是XML注释的,他们推荐自己呢?

0 个答案:

没有答案