23

我只是在查看 F#,如果这是一个愚蠢的问题,我深表歉意,但在 VS2008 F# CTP 1.9.6.2 'Tutorial' 项目中, // 和 /// 都用于注释代码。

两个斜线与三个斜线注释之间是否存在功能差异,或者是惯例(如教程代码中所示)用 /// 注释函数并使用 // 其他所有内容?

4

4 回答 4

41

使用三个斜杠 (///) 是F# 也采用的XML 文档注释的 C# 约定。

于 2008-10-08T01:05:23.717 回答
10

/// 用于文档注释。VS 在生成智能感知信息时会用到它。

于 2008-10-08T01:03:43.937 回答
6

它类似于Java中的/* comment */vs。/** documented comment */

后者的工作原理相同,但也被文档软件识别为开发人员文档 - 而不仅仅是注释。

于 2008-10-08T02:54:10.407 回答
3

/// 或 C# 和 VB.Net 的 ''' 不仅仅是内部注释。如果在项目属性中打开XML 文档文件,则可以使用 Sandcastle 和 HTML 帮助生成四种不同的文档类型(文件和网站)。请参阅https://github.com/EWSoftware/SHFB/wiki微软文档。此外,这可以添加到您的 CI 流程中。

于 2018-04-03T13:08:45.927 回答