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.