nameof 運算式會將變數、型別或成員名稱產生為字串常數。
nameof 運算式會在編譯時間評估，在執行階段則不會有作用。 當運算元是型別或命名空間時，產生的名稱不完整。 下列範例將示範 nameof 運算式的用法：
Console.WriteLine(nameof(System.Collections.Generic)); // output: Generic
Console.WriteLine(nameof(List<int>)); // output: List
Console.WriteLine(nameof(List<>)); // output: List
Console.WriteLine(nameof(List<int>.Count)); // output: Count
Console.WriteLine(nameof(List<int>.Add)); // output: Add
List<int> numbers = new List<int>() { 1, 2, 3 };
Console.WriteLine(nameof(numbers)); // output: numbers
Console.WriteLine(nameof(numbers.Count)); // output: Count
Console.WriteLine(nameof(numbers.Add)); // output: Add
C# 14 和更新版本中支援上述使用 List<> 範例。 您可以使用 nameof運算式，讓檢查引數的程式碼更容易維護：
public string Name
{
get => name;
set => name = value ?? throw new ArgumentNullException(nameof(value), $"{nameof(Name)} cannot be null");
}
你可以在某個方法或其參數的屬性中使用nameof帶有方法參數的表達式。 下列程式碼會示範如何針對方法、區域函式和 Lambda 運算式上的參數屬性執行此動作：
[ParameterString(nameof(msg))]
public static void Method(string msg)
{
[ParameterString(nameof(T))]
void LocalFunction<T>(T param) { }
var lambdaExpression = ([ParameterString(nameof(aNumber))] int aNumber) => aNumber.ToString();
}
當您使用nameof或 CallerArgumentExpression 屬性時，具有參數的 運算式非常有用。
當操作數是 逐字標識符時， @ 字元不是名稱的一部分，如下列範例所示：
var @new = 5;
Console.WriteLine(nameof(@new)); // output: new
C# 語言規格
欲了解更多資訊，請參閱 C# 語言規範中的 Nameof 表達式章節，以及 Extended nameof Scope 功能規範。
