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 还在想如何给多个参数返回值添加文档注释