quando (referência C#)
Use a when
palavra-chave contextual para especificar uma condição de filtro nos seguintes contextos:
- Em uma cláusula de captura de uma
try-catch
outry-catch-finally
declaração. - Como guarda de
switch
caso no depoimento. - Como guarda de caso na
switch
expressão.
when
numa cláusula de captura
A when
palavra-chave pode ser usada em uma cláusula catch para especificar uma condição que deve ser verdadeira para o manipulador para que uma exceção específica seja executada. Sua sintaxe é:
catch (ExceptionType [e]) when (expr)
onde expr é uma expressão que é avaliada como um valor booleano. Se ele retorna true
, o manipulador de exceção executa, se false
, ele não executa.
O exemplo a seguir usa a when
palavra-chave para executar condicionalmente manipuladores para um HttpRequestException dependendo do texto da mensagem de exceção.
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static void Main()
{
Console.WriteLine(MakeRequest().Result);
}
public static async Task<string> MakeRequest()
{
var client = new HttpClient();
var streamTask = client.GetStringAsync("https://localHost:10000");
try
{
var responseText = await streamTask;
return responseText;
}
catch (HttpRequestException e) when (e.Message.Contains("301"))
{
return "Site Moved";
}
catch (HttpRequestException e) when (e.Message.Contains("404"))
{
return "Page Not Found";
}
catch (HttpRequestException e)
{
return e.Message;
}
}
}