为 ValueTuple 中的命名元素添加 XML 文档
Add XML documentation for named elements in ValueTuple
借助 C# 7 中的 ValueTuple
,现在可以编写 return 的方法和属性或使用复合对象,而无需显式声明类型。但是,如果没有提供文档,这些命名元组可能会造成混淆。
由于记录库的主要且可能是最方便的方法是使用 XML 文档,有没有什么方法可以使用 XML 文档来提供命名元组中变量的描述?
我知道显而易见的解决方案是声明一个类型并相应地记录它。但是,鉴于某些 'reasons' 无法完成,是否可以 XML 将数据成员记录在 ValueTuple
中?
注意事项: A similar question was asked ValueTuple
.
来临之前
C# 没有用于记录元组命名元素的特殊语法,您必须使用普通的 <returns>
和 <param>
元素并用文字解释每个命名元素包含的内容。
借助 C# 7 中的 ValueTuple
,现在可以编写 return 的方法和属性或使用复合对象,而无需显式声明类型。但是,如果没有提供文档,这些命名元组可能会造成混淆。
由于记录库的主要且可能是最方便的方法是使用 XML 文档,有没有什么方法可以使用 XML 文档来提供命名元组中变量的描述?
我知道显而易见的解决方案是声明一个类型并相应地记录它。但是,鉴于某些 'reasons' 无法完成,是否可以 XML 将数据成员记录在 ValueTuple
中?
注意事项: A similar question was asked ValueTuple
.
C# 没有用于记录元组命名元素的特殊语法,您必须使用普通的 <returns>
和 <param>
元素并用文字解释每个命名元素包含的内容。