Favicon

Nameof expression

Peponi │ 12/26/2024 │ 2m

C#
SyntaxExpressionnameof

1. Introduction

nameof 식은 컴파일 타임에 변수, 형식, 멤버의 이름을 문자열 상수로 생성한다. Type 또는 namespace가 피연산자에 포함되더라도 생성된 이름은 정규화되지 않는다. 피연산자가 축자 식별자인 경우 @ 문자는 이름에서 제외된다.

2. Example

static void Main(string[] args)
{
    Console.WriteLine(nameof(Main));
    Console.WriteLine(nameof(System));
    Console.WriteLine(nameof(System.Console));             // 정규화되지 않고 Console만 출력
 
    Console.WriteLine(nameof(System.Drawing.Point.X));     // 정규화되지 않고 X만 출력
    Console.WriteLine(nameof(System.Drawing.Point.Y));     // 정규화되지 않고 Y만 출력
 
    var @int = 5;
    Console.WriteLine(nameof(@int));                           // int만 출력
}
 
/* output:
Main
System
Console
X
Y
int
*/

이름이 내용과 동일한 변수 또는 멤버, 변수 검사 등의 경우 nameof를 사용하면 관리를 용이하게 할 수 있다.

string paramA = nameof(paramA);
if (string.IsNullOrWhiteSpace(paramA))
{
    throw new ArgumentException($"{nameof(paramA)} is catched by {nameof(string.IsNullOrWhiteSpace)}", nameof(paramA));
}

C# 11부터는 메서드 또는 메서드 파라미터 특성 내에서 nameof가 사용 가능하다.

internal class CustomAttribute : Attribute
{
    public CustomAttribute(string name) { }
}
 
[Custom(nameof(value))]
void Foo(string value)
{
    [Custom(nameof(localValue))]
    void Local(string localValue) { }
 
    var lambda = (string str1, [Custom(nameof(str1))] string str2) => { };
}

3. 참조 자료