Operatore is (Riferimento per C#)

L'operatore is verifica se il risultato di un'espressione è compatibile con un determinato tipo. Per informazioni sull'operatore di test del tipo is consultare la sezione Operatore is dell'articolo Operatori di cast e di test del tipo. È anche possibile usare l'operatore is per trovare una corrispondenza tra un'espressione e un criterio, come illustrato nell'esempio seguente:

static bool IsFirstFridayOfOctober(DateTime date) =>
    date is { Month: 10, Day: <=7, DayOfWeek: DayOfWeek.Friday };

Nell'esempio precedente l'operatore is corrisponde a un'espressione rispetto a un criterio di proprietà con costanti annidate e criteri relazionali.

L'operatore is può essere utile negli scenari seguenti:

  • Controllare il tipo di runtime di un'espressione, come illustrato nell'esempio seguente:

    int i = 34;
    object iBoxed = i;
    int? jNullable = 42;
    if (iBoxed is int a && jNullable is int b)
    {
        Console.WriteLine(a + b);  // output 76
    }
    

    Nell'esempio precedente viene illustrato l'uso di un criterio di dichiarazione.

  • Verificare la presenza di null, come illustrato nell'esempio seguente:

    if (input is null)
    {
        return;
    }
    

    Quando si trova una corrispondenza tra un'espressione e null, il compilatore garantisce che non venga richiamato alcun operatore == o != di overload dell'utente.

  • È possibile usare un criterio di negazione per eseguire un controllo non null, come illustrato nell'esempio seguente:

    if (result is not null)
    {
        Console.WriteLine(result.ToString());
    }
    
  • A partire da C# 11, è possibile usare criteri di elenco per trovare le corrispondenze con gli elementi di un elenco o di una matrice. Il codice seguente controlla le matrici per i valori Integer nelle posizioni previste:

    int[] empty = [];
    int[] one = [1];
    int[] odd = [1, 3, 5];
    int[] even = [2, 4, 6];
    int[] fib = [1, 1, 2, 3, 5];
    
    Console.WriteLine(odd is [1, _, 2, ..]);   // false
    Console.WriteLine(fib is [1, _, 2, ..]);   // true
    Console.WriteLine(fib is [_, 1, 2, 3, ..]);     // true
    Console.WriteLine(fib is [.., 1, 2, 3, _ ]);     // true
    Console.WriteLine(even is [2, _, 6]);     // true
    Console.WriteLine(even is [2, .., 6]);    // true
    Console.WriteLine(odd is [.., 3, 5]); // true
    Console.WriteLine(even is [.., 3, 5]); // false
    Console.WriteLine(fib is [.., 3, 5]); // true
    

Nota

Per l'elenco completo dei criteri supportati dall'operatore is, consultare Criteri.

Specifiche del linguaggio C#

Per ulteriori informazioni, consultare la sezione Operatore is della specifica del linguaggio C# e Criteri di ricerca.

Vedi anche