Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

when: referência prática

when: referência prática: when adiciona um filtro a catch ou uma guarda a um padrão switch.

Versão: C# language; verified against C# 14 reference

Sintaxe

when /* grammar-specific form */

when adiciona um filtro a catch ou uma guarda a um padrão switch.

Usa-o para restringir um caso sem capturar uma exceção que não se qualifica.

O filtro deve ser seguro e sem efeitos; false continua a procura de um handler.

Uma exceção lançada pelo filtro de exceções é tratada como false.

O programa completo usa realmente when; o stdout exato esperado é filtered.

Exemplos

using System;
using System.Buffers;
using System.Collections.Concurrent;
using System.Collections.Frozen;
using System.Collections.Generic;
using System.Collections.Immutable;
using System.Diagnostics;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Linq.Expressions;
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
using System.Text;
using System.Text.Json;
using System.Text.Json.Nodes;
using System.Text.Json.Serialization;
using System.Text.RegularExpressions;
using System.Threading;
using System.Threading.Channels;
using System.Threading.Tasks;
using Number = System.Int32;

try { throw new ArgumentException("x"); } catch (ArgumentException error) when (error.Message.StartsWith("x")) { Console.WriteLine("filtered"); }

Resultado

filtered

O programa completo usa realmente `when`; o stdout exato esperado é `filtered`.

Fontes