title | author | date | CreateTime | categories |
---|---|---|---|---|
C# 如何给 ValueTuple 返回值添加注释 |
lindexi |
2019-08-31 16:55:58 +0800 |
2019-05-14 12:27:30 +0800 |
C# |
在 C# 7.0 可以在一个方法的返回,返回多个参数,通过 ValueTuple 的方法,但是和单个参数返回不同的是,如何对多个参数返回每个参数进行单独的注释?
如使用下面的代码,我尝试在一个方法返回两个不同的概念的值,在之前,如果通过 out 的返回,我可以单独给每个参数做注释
static (int s, int t) F(int x, int y)
{
return (x + y, x - y);
}
我找了很多博客,发现可以使用的方法是在返回值注释里面使用 para 分割多个参数
/// <returns>
/// <para>
/// 注释 s 参数
/// </para>
/// <para>
/// 注释 t 参数
/// </para>
/// </returns>
static (int s, int t) F(int x, int y)
{
return (x + y, x - y);
}
现在 Proposal: multiple returns tags and name attributes in doc comments for a tuple return value · Issue #145 · dotnet/csharplang 还在想如何给多个参数返回值添加文档注释
如果你有好想法,欢迎在这个帖子 回复