有没有一个标准(如phpdoc或python的docstring)评论C#代码?

前端之家收集整理的这篇文章主要介绍了有没有一个标准(如phpdoc或python的docstring)评论C#代码?前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
有没有一个标准约定(如PHPdoc或 python的docstring)来评论C#代码,以便可以从源代码自动生成类文档?
您可以使用 XML样式的注释,并使用工具将这些注释引入API文档.

这是一个评论风格的例子:

/// <summary>
/// Authenticates a user based on a username and password.
/// </summary>
/// <param name="username">The username.</param>
/// <param name="password">The password.</param>
/// <returns>
/// True,if authentication is successful,otherwise False.
/// </returns>
/// <remarks>
/// For use with local systems
/// </remarks>
public override bool Authenticate(string username,string password)

有些项目是为了促进这一点:

GhostDoc,它为单个快捷键提供一个类或方法自动生成注释.
Sandcastle,它从XML注释生成MSDN样式文档.

原文链接:https://www.f2er.com/php/140102.html

猜你在找的PHP相关文章