C#5.0新增功能02 调用方信息
Posted savionzhang
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了C#5.0新增功能02 调用方信息相关的知识,希望对你有一定的参考价值。
通过使用调用方信息特性,可获取有关方法的调用方的信息。 可以获取源代码的文件路径、源代码中的行号和调用方的成员名称。 此信息有助于跟踪、调试和创建诊断工具。若要获取此信息,可以使用应用于可选参数的特性,每个特性都具有默认值。 下表列出在 System.Runtime.CompilerServices 命名空间中定义的调用方信息特性:
特性 | 描述 | 类型 |
---|---|---|
CallerFilePathAttribute | 包含调用方的源文件的完整路径。 这是编译时的文件路径。 | String |
CallerLineNumberAttribute | 源文件中调用方法的行号。 | Integer |
CallerMemberNameAttribute | 调用方的方法或属性名称。 请参阅本主题后面的成员名称。 | String |
示例
下面的示例演示如何使用调用方信息特性。 每次调用 TraceMessage
方法时,调用方信息将替换为可选参数的变量。
1 public void DoProcessing() 2 3 TraceMessage("Something happened."); 4 5 6 public void TraceMessage(string message, 7 [System.Runtime.CompilerServices.CallerMemberName] string memberName = "", 8 [System.Runtime.CompilerServices.CallerFilePath] string sourceFilePath = "", 9 [System.Runtime.CompilerServices.CallerLineNumber] int sourceLineNumber = 0) 10 11 System.Diagnostics.Trace.WriteLine("message: " + message); 12 System.Diagnostics.Trace.WriteLine("member name: " + memberName); 13 System.Diagnostics.Trace.WriteLine("source file path: " + sourceFilePath); 14 System.Diagnostics.Trace.WriteLine("source line number: " + sourceLineNumber); 15 16 17 // 输出结果: 18 // message: Something happened. 19 // member name: DoProcessing 20 // source file path: c:\\Visual Studio Projects\\CallerInfoCS\\CallerInfoCS\\Form1.cs 21 // source line number: 31
备注
你必须为每个可选参数指定显式默认值。 不能将调用方信息特性应用于未指定为可选的参数。
调用方信息特性不会使参数成为可选参数。 相反,它们会在忽略此参数时影响传入的默认值。
在编译时,调用方信息值将作为文本传入中间语言 (IL)。 与异常的 StackTrace 属性的结果不同,这些结果不受模糊处理的影响。
你可显式提供可选参数来控制调用方信息或隐藏调用方信息。
成员名称
可以使用 CallerMemberName
特性来避免将成员名称指定为所调用的方法的 String
参数。 通过使用这种技术,可以避免“重命名重构”不更改 String
值的问题。 此好处对于以下任务特别有用:
-
使用跟踪和诊断例程。
-
在绑定数据时实现 INotifyPropertyChanged 接口。 此接口允许对象的属性通知绑定控件该属性已更改,以便此控件能够显示更新的信息。 如果没有
CallerMemberName
特性,则必须将属性名称指定为文本。
以下图表显示在使用 CallerMemberName
特性时返回的成员名称。
调用发生中 | 成员名称结果 |
---|---|
方法、属性或事件 | 从中发起调用的方法、属性或事件的名称。 |
构造函数 | 字符串“.ctor” |
静态构造函数 | 字符串“.cctor” |
析构函数 | 字符串“Finalize” |
用户定义的运算符或转换 | 为成员生成的名称,例如,“op_Addition”。 |
特性构造函数 | 要应用特性的方法或属性的名称。 如果该特性是成员中的任何元素(如参数、返回值或泛型参数),则此结果是与该元素关联的成员的名称。 |
无包含的成员(例如,程序集级别或应用于类型的特性) | 可选参数的默认值。 |
以上是关于C#5.0新增功能02 调用方信息的主要内容,如果未能解决你的问题,请参考以下文章
新增支持Hive数据源,引入新图表类型词云图,DataEase开源数据可视化分析平台v1.5.0发布
.net5 core Razor项目实战系列之九:用户管理功能的实现 (新增修改用户)
CloudQuery v2.0.0 发布 | 新增数据保护数据变更连接管理等功能
EMQX Newsletter 2022-07|EMQX 5.0 正式发布EMQX Cloud 新增 2 个数据库集成