分享方式

運算子 is （C# 參考）

is運算子會檢查表達式的結果是否與指定的類型相容。 如需類型測試is運算符的相關信息，請參閱 Type-testing 和 cast 運算子一文的 is 運算子一節。 您也可以使用 is 運算符來比對模式的運算式，如下列範例所示：

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

在上述範例中is，運算符會比對具有巢狀常數和關係模式的屬性模式的表達式。

C# 語言參考資料記錄了 C# 語言最新版本。 同時也包含即將推出語言版本公開預覽功能的初步文件。

文件中標示了語言最近三個版本或目前公開預覽版中首次引入的任何功能。

小提示

欲查詢某功能何時首次在 C# 中引入，請參閱 C# 語言版本歷史的條目。

運算子 is 在下列案例中很有用：

  • 若要檢查表達式的運行時間類型，如下列範例所示：

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

    上述範例顯示 宣告模式的使用方式。

  • 若要檢查 null，如下列範例所示：

    if (input is null)
{
    return;
}

    當您比對 null表達式時，編譯程式會保證不會叫用任何使用者多載 == 或 != 運算符。

  • 要透過否定 模式進行非空檢查，如下範例所示：

    if (result is not null)
{
    Console.WriteLine(result.ToString());
}

  • 透過使用 串列模式來匹配列表或陣列的元素。 下列程式代碼會檢查陣列中是否有預期位置的整數值：

    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

備註

如需運算子所支援的 is 模式完整清單，請參閱 模式。

C# 語言規格

如需詳細資訊，請參閱 C# 語言規格和模式比對的 is 運算子一節。

另請參閱

  • Last updated on