C# 中位置记录属性的文档注释

Question

如果我有这样的位置记录：

public record Version(int Major, int Minor);

看来我只能提供<summary>的文档，像这样：

/// <summary>
/// Version record
/// </summary>
public record Version(int Major, int Minor);

是否可以在保持简短记录语法的同时记录 Major 和 Minor 属性（也可能是构造函数参数）？

Answer 1

正如 canton7 指出的那样，这是still under development。

目前记录属性和参数的最佳解决方法是明确定义属性，同时保持记录的位置：

/// <summary>
/// Version record
/// </summary>
/// <param name="Major">Major constructor parameter</param>
/// <param name="Minor">Minor constructor paramater</param>
public record Version(int Major, int Minor)
{
    /// <summary>
    /// Major Property
    /// </summary>
    public int Major { get; init; } = Major;

    /// <summary>
    /// Minor property
    /// </summary>
    public int Minor { get; init; } = Minor;
}

这比自己定义构造函数略短，但更有用的是，添加支持后，您可以将文档移动到主构造函数，同时知道这不会以任何方式更改生成的代码。如果您想从另一个位置记录继承，也有必要这样做。

Answer 2

你可以这样记录：

/// <summary>
/// Version record
/// </summary>
/// <param name="Major">Major version</param>
/// <param name="Minor">Minor version</param>
public record Version(int Major, int Minor);

然后你在代码中使用它时就有了文档：