CSharp Keyword when filter condition

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C#: when — умова фільтра

Довідник C# · Практичне керівництво

Фільтрує виняток catch або додає умову до гілки pattern matching.

Простий приклад (Example.cs)

Збережіть цей приклад окремо як Example.cs. Запускайте його незалежно від інших прикладів на сторінці.

Example.cs:

// PROJECT-EXAMPLE
try { throw new System.Exception("sample"); }
catch (System.Exception error) when (error.Message == "sample")
{
    System.Console.WriteLine("Matched");
}

Результат:

Matched

Синтаксис

catch (Exception e) when (condition) / case pattern when condition:

Приклад 1: базова форма

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        try { throw new ArgumentException("sample", "count"); }
        catch (ArgumentException error) when (error.ParamName == "count") { Console.WriteLine("Handled count"); }
    }
}

Приклад 2: інша практична форма

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        object value = 20;
        switch (value) { case int number when number > 10: Console.WriteLine("Large"); break; case int: Console.WriteLine("Small"); break; }
    }
}

Офіційне джерело: Microsoft Learn.