编辑“︁C Sharp 注释”︁（章节）

== XML文档注释详解 ==
XML文档注释可通过编译器生成正式的API文档。常用标签包括：

{| class="wikitable"
|-
! 标签 !! 描述
|-
| <code><summary></code> || 类型或成员的简要说明
|-
| <code><remarks></code> || 详细说明
|-
| <code><param></code> || 方法参数说明
|-
| <code><returns></code> || 返回值说明
|-
| <code><exception></code> || 可能抛出的异常
|-
| <code><example></code> || 使用示例
|}

示例：
<syntaxhighlight lang="csharp">
/// <summary>
/// 计算圆的面积
/// </summary>
/// <param name="radius">圆的半径，必须大于0</param>
/// <returns>圆的面积</returns>
/// <exception cref="ArgumentException">当radius小于等于0时抛出</exception>
/// <example>
/// <code>
/// double area = CalculateCircleArea(5.0);
/// </code>
/// </example>
public double CalculateCircleArea(double radius)
{
    if (radius <= 0)
        throw new ArgumentException("半径必须大于0", nameof(radius));
    
    return Math.PI * radius * radius;
}
</syntaxhighlight>