.NET6新东西--CallerArgumentExpression

2021-11-15 15:32:42 浏览数 (1)

在.NET6中我们可以使用CallerArgumentExpression很方便的获取调用方的信息,它可以帮助开发人员简化很多代码,让代码更加简洁。下面我们就来讲解一下吧。 其实在很早.NET就支持自动获取调用方的信息了,在.NET6以前我们如果要获取调用方的信息可以使用这三个Caller Info Attribute:

  • CallerMemberName:调用方名称,方法名或者属性名;
  • CallerFilePath:调用方源代码的位置;
  • CallerLineNumber:调用方位于源代码的第几行。

具体的使用方法是在方法参数中加入上面任意一个属性就可以获取调用方对应的信息,例如下面的代码:

代码语言:javascript复制
using System.Runtime.CompilerServices;

Console.WriteLine("Hello, World!");
DumpCallerInfo();
static void DumpCallerInfo([CallerFilePath] string? callerFilePath = null, [CallerLineNumber] int? callerLineNumber = null, [CallerMemberName] string? callerMemberName = null)
{
    Console.WriteLine("Caller info:");
    Console.WriteLine($@"CallerFilePath: {callerFilePath} CallerLineNumber: {callerLineNumber} CallerMemberName: {callerMemberName}");
}

这里要注意的是 CallerLineNumber的类型是int,所以对应的参数类型就只能是int、int?或者long。上面代码运行输出的结果是:

同样,新增的CallerArgumentExpression也是一种caller info,一般会用它来自动获取传进来的参数表达式,例如:

代码语言:javascript复制
using System.Runtime.CompilerServices;

Console.WriteLine("Hello, World!");
DumpCallerInfo("张三");
static void DumpCallerInfo(string name,[CallerArgumentExpression("name")] string? CallerArgumentExpression=null)
{
    Console.WriteLine("Caller info:");
    Console.WriteLine(CallerArgumentExpression);
}

如果没有变量名和属性名则会显示value的字面量,如果传进来的是一个表达式,则会显示出变大时本身。这相比前面所说的那三个Attribute来说代码简化了很多。在.NET6中的 ArgumentNullException.ThrowIfNull()方法就是利用CallerArgumentExpression实现的。 本篇文章只是简单的讲解了一下CallerArgumentExpression,更详细的内容请参阅微软官方文档。

0 人点赞