is-Operator (C#-Referenz)

Der is-Operator überprüft, ob das Ergebnis eines Ausdrucks mit einem bestimmten Typ kompatibel ist. Informationen zu Typtests des is-Operators finden Sie im Abschnitt is-Operator des Artikels Typtestoperatoren und Cast-Ausdrücke. Sie können den is-Operator auch verwenden, um einen Ausdruck mit einem Muster abzugleichen, wie im folgenden Beispiel gezeigt:

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

Im vorherigen Beispiel vergleicht der is-Operator einen Ausdruck mit einem Eigenschaftsmuster mit geschachtelten konstanten und relationalen Mustern.

Der is-Operator kann in den folgenden Szenarien nützlich sein:

  • So prüfen Sie den Laufzeittyp eines Ausdrucks, wie im folgenden Beispiel gezeigt:

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

    Das vorherige Beispiel zeigt die Verwendung eines Deklarationsmusters.

  • So prüfen Sie auf null, wie im folgenden Beispiel gezeigt:

    if (input is null)
    {
        return;
    }
    

    Wenn Sie einen Ausdruck mit null abgleichen, garantiert der Compiler, dass kein vom Benutzer überladener ==- oder !=-Operator aufgerufen wird.

  • Sie können ein negiertes Muster verwenden, um auf nicht NULL zu prüfen, wie im folgenden Beispiel gezeigt:

    if (result is not null)
    {
        Console.WriteLine(result.ToString());
    }
    
  • Ab C# 11 können Sie Listenmuster verwenden, um Elemente einer Liste oder eines Arrays abzugleichen. Der folgende Code überprüft Arrays auf Integer-Werte in erwarteten Positionen:

    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
    

Hinweis

Eine vollständige Liste der vom is-Operator unterstützten Muster finden Sie unter Muster.

C#-Sprachspezifikation

Weitere Informationen finden Sie im Abschnitt Der is-Operator der C#-Sprachspezifikation und Musterabgleich.

Siehe auch