! (null-forgiving) 연산자(C# 참조)

단항 후위 ! 연산자는 null-forgiving 또는 null-suppression 연산자입니다. 사용하도록 설정된 nullable 주석 컨텍스트에서 null-forgiving 연산자를 사용하여 이전 식에 대한 모든 null 허용 경고를 표시하지 않습니다. 단항 접두사 ! 연산자는 논리 부정 연산자입니다. null-forgiving 연산자는 런타임에 영향을 주지 않습니다. 식의 null 상태를 변경하여 컴파일러의 정적 흐름 분석에만 영향을 줍니다. 런타임에서 x! 식은 기본 식 x의 결과로 계산됩니다.

nullable 참조 형식 기능에 대한 자세한 내용은 nullable 참조 형식을 참조하세요.

C# 언어 참조는 가장 최근에 릴리스된 C# 언어 버전을 문서화합니다. 또한 예정된 언어 릴리스의 공개 미리 보기 기능에 대한 초기 설명서도 포함되어 있습니다.

설명서는 언어의 마지막 세 버전 또는 현재 공개 미리 보기에서 처음 도입된 기능을 식별합니다.

팁 (조언)

C#에서 기능이 처음 도입된 시기를 찾으려면 C# 언어 버전 기록에 대한 문서를 참조하세요.

예제

null-forgiving 연산자의 한 가지 사용 사례는 인수 유효성 검사 논리를 테스트하는 것입니다. 예를 들어 다음 클래스를 예로 들어 볼 수 있습니다.

#nullable enable
public class Person
{
    public Person(string name) => Name = name ?? throw new ArgumentNullException(nameof(name));

    public string Name { get; }
}

MSTest 테스트 프레임워크를 사용하여 생성자에서 유효성 검사 논리에 대해 다음 테스트를 만들 수 있습니다.

[TestMethod, ExpectedException(typeof(ArgumentNullException))]
public void NullNameShouldThrowTest()
{
    var person = new Person(null!);
}

null-forgiving 연산자가 없으면 컴파일러가 이전 코드에 대해 다음 경고를 생성합니다. Warning CS8625: Cannot convert null literal to non-nullable reference type. null-forgiving 연산자를 사용하면 전달 null 이 예상되며 경고를 생성해서는 안 됨을 컴파일러에 알릴 수 있습니다.

식이 될 수 없지만 컴파일러에서 인식할 수 없다는 null 것을 확실히 알고 있는 경우 null 용서 연산자를 사용할 수도 있습니다. 다음 예에서는 IsValid 메서드가 true를 반환하는 경우 해당 인수는 null이 아니므로 안전하게 역참조할 수 있습니다.

public static void Main()
{
    Person? p = Find("John");
    if (IsValid(p))
    {
        Console.WriteLine($"Found {p!.Name}");
    }
}

public static bool IsValid(Person? person)
    => person is not null && person.Name is not null;

null-forgiving 연산자가 없으면 컴파일러가 p.Name 코드에 대해 다음 경고를 생성합니다. Warning CS8602: Dereference of a possibly null reference.

IsValid 메서드를 수정할 수 있는 경우 NotNullWhen 특성을 사용하여 메서드가 IsValid를 반환할 때 null 메서드의 인수는 true일 수 없다는 것을 컴파일러에 알릴 수 있습니다.

public static void Main()
{
    Person? p = Find("John");
    if (IsValid(p))
    {
        Console.WriteLine($"Found {p.Name}");
    }
}

public static bool IsValid([NotNullWhen(true)] Person? person)
    => person is not null && person.Name is not null;

앞의 예제에서는 컴파일러가 p 문 내에서 null가 if일 수 없다는 것을 확인할 수 있는 충분한 정보를 제공하기 때문에 null-forgiving 연산자를 사용할 필요가 없습니다. 변수의 null 상태에 대한 추가 정보를 제공하는 데 사용할 수 있는 특성에 대한 자세한 내용은 null 예상을 정의하는 특성을 포함한 API 업그레이드를 참조하세요.

C# 언어 사양

자세한 내용은 Nullable 참조 형식 사양 초안의 null-forgiving 연산자 섹션을 참조하세요.

참고 항목

• 불필요한 제거 연산자 제거(스타일 규칙 IDE0080)
• C# 연산자 및 식
• 자습서: null 허용 참조 형식을 사용한 디자인