???? und ??= (Operatoren) – C#-Referenzand ??= operators (C# reference)

Der NULL-Zusammenfügungsoperator ?? gibt den Wert des linken Operanden zurück, wenn dieser nicht null ist. Andernfalls wertet der Operator den rechten Operanden aus und gibt dessen Ergebnis zurück.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. Der ??-Operator wertet seinen rechten Operanden nicht aus, wenn der linke Operand auf einen Wert ungleich NULL ausgewertet wird.The ?? operator doesn't evaluate its right-hand operand if the left-hand operand evaluates to non-null.

Ab C# 8.0 können Sie den NULL-Sammelzuweisungsoperator ??= verwenden, um den Wert des rechten Operanden dem linken Operanden nur dann zuzuweisen, wenn die Auswertung des linken Operanden null ergibt.Available in C# 8.0 and later, the null-coalescing assignment operator ??= assigns the value of its right-hand operand to its left-hand operand only if the left-hand operand evaluates to null. Der ??=-Operator wertet seinen rechten Operanden nicht aus, wenn der linke Operand auf einen Wert ungleich NULL ausgewertet wird.The ??= operator doesn't evaluate its right-hand operand if the left-hand operand evaluates to non-null.

List<int> numbers = null;
int? a = null;

(numbers ??= new List<int>()).Add(5);
Console.WriteLine(string.Join(" ", numbers));  // output: 5

numbers.Add(a ??= 0);
Console.WriteLine(string.Join(" ", numbers));  // output: 5 0
Console.WriteLine(a);  // output: 0

Der linke Operand des ??=-Operators muss eine Variable, eine Eigenschaft oder ein Indexer-Element sein.The left-hand operand of the ??= operator must be a variable, a property, or an indexer element.

In C# 7.3 und früheren Versionen muss der Typ des linken Operanden des ??-Operators entweder ein Verweistyp oder ein Nullable-Werttyp sein.In C# 7.3 and earlier, the type of the left-hand operand of the ?? operator must be either a reference type or a nullable value type. Ab C# 8.0 wird diese Anforderung durch Folgendes ersetzt: der Typ des linken Operanden der Operatoren ?? und ??= kann kein Werttyp sein, der nicht auf NULL festgelegt werden kann.Beginning with C# 8.0, that requirement is replaced with the following: the type of the left-hand operand of the ?? and ??= operators cannot be a non-nullable value type. Das heißt, Sie können ab C# 8.0 die NULL-Sammeloperatoren mit uneingeschränkten Typparametern verwenden:In particular, beginning with C# 8.0, you can use the null-coalescing operators with unconstrained type parameters:

private static void Display<T>(T a, T backup)
{
    Console.WriteLine(a ?? backup);
}

Die NULL-Sammeloperatoren sind rechtsassoziativ.The null-coalescing operators are right-associative. Das heißt, Ausdrücke wieThat is, expressions of the form

a ?? b ?? c
d ??= e ??= f

werden wie folgt ausgewertetare evaluated as

a ?? (b ?? c)
d ??= (e ??= f)

BeispieleExamples

Die Operatoren ?? und ??= können in folgenden Szenarios nützlich sein:The ?? and ??= operators can be useful in the following scenarios:

  • In Ausdrücken mit den NULL-bedingten Operatoren „?.“ und „?[]“ können Sie den ??-Operator verwenden, um einen alternativen Ausdruck zum Auswerten für den Fall bereitzustellen, dass das Ergebnis des NULL-bedingten Vorgangs null ist:In expressions with the null-conditional operators ?. and ?[], you can use the ?? 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
    
  • Wenn Sie mit Nullable-Werttypen arbeiten und den Wert eines zugrunde liegenden Werttyps bereitstellen müssen, verwenden Sie den ??-Operator, um den Wert für den Fall anzugeben, dass der Wert eines Nullable-Typs null ist:When you work with nullable value types and need to provide a value of an underlying value type, use the ?? 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
    

    Verwenden Sie die Nullable<T>.GetValueOrDefault()-Methode, wenn der Wert, der verwenden werden soll, falls der Wert des Nullable-Typs null lautet, der Standardwert des zugrunde liegenden Werttyps sein soll.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.

  • Ab C# 7.0 können Sie einen throwAusdruck als rechten Operanden des ??-Operators verwenden, um den Code für die Überprüfung der Argumente präziser zu fassen:Beginning with C# 7.0, you can use a throw expression as the right-hand operand of the ?? 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");
    }
    

    Das oben stehende Beispiel veranschaulicht auch, wie Sie Ausdruckskörpermember verwenden, um eine Eigenschaft zu definieren.The preceding example also demonstrates how to use expression-bodied members to define a property.

  • Ab C# 8.0 können Sie mit dem ??=-Operator den CodeBeginning with C# 8.0, you can use the ??= operator to replace the code of the form

    if (variable is null)
    {
        variable = expression;
    }
    

    durch den folgenden Code:with the following code:

    variable ??= expression;
    

OperatorüberladbarkeitOperator overloadability

Die Operatoren ?? und ??= können nicht überladen werden.The operators ?? and ??= cannot be overloaded.

C#-SprachspezifikationC# language specification

Weitere Informationen über den ??-Operator finden Sie im Abschnitt NULL-Sammeloperatoren der C#-Sprachspezifikation.For more information about the ?? operator, see The null coalescing operator section of the C# language specification.

Weitere Informationen zum ??=-Operator finden Sie unter Hinweis zum Featurevorschlag.For more information about the ??= operator, see the feature proposal note.

Siehe auchSee also