C#如何使用nameof表达式 C# nameof运算符使用技巧

新闻中心 NEWS CENTER

2025-12-14

浏览次数：次

nameof 是 C# 6.0 引入的编译时运算符，将标识符转换为字符串字面量，支持重构、避免拼写错误，适用于变量、属性、方法、类型等，但不支持表达式或动态名称。

c#如何使用nameof表达式 c# nameof运算符使用技巧

nameof 是 C# 6.0 引入的编译时运算符，它不执行任何运行时操作，只在编译期将标识符（如变量名、方法名、属性名、类型名等）转换为对应的字符串字面量。它安全、高效，且支持重构 —— 重命名时自动同步，不会出现“魔法字符串”问题。

传统写法容易出错：

if (value == null) throw new ArgumentNullException("valu"); // 拼错！

用 nameof 后，拼写由编译器保障：

if (value == null) throw new ArgumentNullException(nameof(value));

IDE 重命名 value 变量时，nameof(value) 会自动更新，不会遗漏。

nameof 可作用于：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

185 查看详情挖错网

注意：不能用于表达式或字符串拼接，例如 nameof(x + y) 或 nameof("abc") 都会编译失败。

常见模式示例：

参数验证：Guard.Against.Null(user, nameof(user))
日志记录：logger.LogWarning("Failed to process {PropertyName}", nameof(Config.TimeoutMs))
INotifyPropertyChanged：OnPropertyChanged(nameof(FirstName))（比 "FirstName" 更安全）
配置绑定提示：当配置项缺失时，提示用户检查 nameof(AppSettings.DatabaseUrl) 对应的配置键

几个实用细节：

支持点号访问，但只解析到最后一个标识符：nameof(obj.Property) 和 nameof(Property) 结果相同
泛型类型名带反引号和数字：nameof(List<string>)</string> 返回 "List`1"，不是 "List"
可用于 const string 初始化：private const string NameKey = nameof(User.Name);（编译期确定）
不能用于动态对象、匿名类型属性、或未声明的名称 —— 编译器必须能静态识别该标识符

基本上就这些。用好 nameof，代码更健壮，重构更安心。

以上就是C#如何使用nameof表达式 C# nameof运算符使用技巧的详细内容，更多请关注其它相关文章！