???? operator (Справочник по C#)operator (C# Reference)

Оператор объединения с NULL ?? возвращает значение своего операнда слева, если его значение не равно null. В противном случае он вычисляет операнд справа и возвращает его результат.The null-coalescing operator ?? returns the value of its left-hand operand if it isn't null; otherwise, it evaluates the right-hand operand and returns its result. Оператор ?? не выполняет оценку своего операнда справа, если его операнд слева имеет значение, отличное от NULL.The ?? operator doesn't evaluate its right-hand operand if the left-hand operand evaluates to non-null.

Оператор объединения с NULL имеет правую ассоциативность, то есть выражение формыThe null-coalescing operator is right-associative, that is, an expression of the form

a ?? b ?? c

вычисляется какis evaluated as

a ?? (b ?? c)

Оператор ?? может быть полезен в таких случаях:The ?? operator can be useful in the following scenarios:

  • В выражениях с NULL-условными операторами ?. и ?[] можно использовать оператор объединения с NULL, чтобы задать альтернативное выражение для оценки на случай, если результат выражения с NULL-условной операцией будет равен null.In expressions with the null-conditional operators ?. and ?[], you can use the null-coalescing operator to provide an alternative expression to evaluate in case the result of the expression with null-conditional operations is null:

    double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)
    {
        return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;
    }
    
    var sum = SumNumbers(null, 0);
    Console.WriteLine(sum);  // output: NaN
    
  • При работе с типами, допускающими значение NULL, и если нужно указать значение базового типа значения, используйте оператор объединения с NULL для указания значения, возвращаемого в том случае, если значение типа, допускающего значение NULL, равно null.When you work with nullable value types and need to provide a value of an underlying value type, use the null-coalescing operator to specify the value to provide in case a nullable type value is null:

    int? a = null;
    int b = a ?? -1;
    Console.WriteLine(b);  // output: -1
    

    Используйте метод Nullable<T>.GetValueOrDefault(), если значение, которое будет использоваться, когда значение типа, допускающего значение NULL, равно null, должно быть значением по умолчанию базового типа.Use the Nullable<T>.GetValueOrDefault() method if the value to be used when a nullable type value is null should be the default value of the underlying value type.

  • Начиная с C# 7.0 можно сократить код проверки аргументов, используя выражение throw в качестве правого операнда оператора объединения с NULL:Starting with C# 7.0, you can use a throw expression as the right-hand operand of the null-coalescing operator to make the argument-checking code more concise:

    public string Name
    {
        get => name;
        set => name = value ?? throw new ArgumentNullException(nameof(value), "Name cannot be null");
    }
    

    В предыдущем примере также демонстрируются способы определения свойства с помощью членов, заданных выражениями.The preceding example also demonstrates how to use expression-bodied members to define a property.

Возможность перегрузки оператораOperator overloadability

Оператор объединения с NULL перегружать нельзя.The null-coalescing operator cannot be overloaded.

Спецификация языка C#C# language specification

Дополнительные сведения см. в разделе об операторе объединения со значением NULL в спецификации языка C#.For more information, see The null coalescing operator section of the C# language specification.

См. такжеSee also