?? et ?? =, opérateurs (référence C#)

L’opérateur de fusion null ?? retourne la valeur de l’opérande de gauche si elle n’est pas null ; sinon, il évalue l’opérande de droite et retourne son résultat. L’opérateur ?? n’évalue pas son opérande droit si l’opérande gauche a la valeur non Null.

Disponible en C# 8,0 et versions ultérieures, l’opérateur ??= d’assignation de fusion Null affecte la valeur de son opérande droit à son opérande de gauche uniquement si l’opérande de gauche est évalué à null . L’opérateur ??= n’évalue pas son opérande droit si l’opérande gauche a la valeur 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

L’opérande gauche de l' ??= opérateur doit être une variable, une ??=ou un élément d' indexeur .

En C# 7,3 et versions antérieures, le type de l’opérande gauche de l' ?? opérateur doit être un type ?? ou un type valeur Nullable. À compter de C# 8,0, cette spécification est remplacée par ce qui suit : le type de l’opérande gauche des ?? opérateurs et ??= ne peut pas être un type valeur non Nullable. En particulier, à compter de C# 8,0, vous pouvez utiliser les opérateurs de fusion Null avec des paramètres de type sans contrainte :

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

Les opérateurs de fusion Null sont associatifs à droite. Autrement dit, les expressions de la forme

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

sont évaluées comme

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

Exemples

Les ?? opérateurs et ??= peuvent être utiles dans les scénarios suivants :

  • Dans les expressions avec les opérateurs conditionnels null ?. et ? [], vous pouvez utiliser l' opérateur pour fournir une autre expression à évaluer au cas où le résultat de l’expression avec des opérations conditionnelles null est null :

    double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)
    {
        return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;
    }
    
    var sum = SumNumbers(null, 0);
    Console.WriteLine(sum);  // output: NaN
    
  • Quand vous utilisez des types valeur Nullable et que vous devez fournir une valeur d’un type valeur sous-jacent, utilisez l' opérateur pour spécifier la valeur à fournir dans le cas où une valeur de type Nullable est null :

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

    Utilisez la méthode Nullable<T>.GetValueOrDefault() si la valeur à utiliser quand une valeur de type Nullable est null doit être la valeur par défaut du type valeur sous-jacent.

  • À compter de C# 7,0, vous pouvez utiliser une expression comme opérande de droite de l' ?? opérateur pour rendre le code de vérification d’argument plus concis :

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

    L’exemple précédent montre également comment utiliser des membres expression-bodied pour définir une propriété.

  • À compter de C# 8,0, vous pouvez utiliser l' ??= opérateur pour remplacer le code du formulaire.

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

    par le code suivant :

    variable ??= expression;
    

Capacité de surcharge de l’opérateur

Les opérateurs ?? et ??= ne peuvent pas être surchargés.

spécification du langage C#

Pour plus d’informations sur l' ?? opérateur, consultez ?? de la spécification du langage C#.

Pour plus d’informations sur l' ??= opérateur, consultez la ??=à la proposition de fonctionnalité.

Voir aussi