when(C# 참조)

컨텍스트 키워드를 when 사용하여 다음 컨텍스트에서 필터 조건을 지정합니다.

• 또는 try-catch 문의 catch 절에서 try-catch-finally
• 문의 케이스 가드로switch.
• 식에서 대/소문자 보호로 사용합니다switch.

C# 언어 참조는 가장 최근에 릴리스된 C# 언어 버전을 문서화합니다. 또한 예정된 언어 릴리스의 공개 미리 보기 기능에 대한 초기 설명서도 포함되어 있습니다.

설명서는 언어의 마지막 세 버전 또는 현재 공개 미리 보기에서 처음 도입된 기능을 식별합니다.

팁 (조언)

C#에서 기능이 처음 도입된 시기를 찾으려면 C# 언어 버전 기록에 대한 문서를 참조하세요.

when catch 절에서

catch 절의 when 키워드를 사용하여 특정 예외가 실행될 처리기에 대해 true여야 하는 조건을 지정합니다. 구문은 다음과 같습니다.

catch (ExceptionType [e]) when (expr)

여기서 expr 은 부울 값으로 계산되는 식입니다. 반환 true되는 경우 예외 처리기가 실행됩니다. 그렇지 않으면 false예외 처리기가 실행됩니다.

키워드가 when 있는 예외 필터는 더 나은 디버깅 지원 및 성능 이점을 포함하여 기존의 예외 처리 방법보다 몇 가지 이점을 제공합니다. 예외 필터가 호출 스택을 유지하고 디버깅을 개선하는 방법에 대한 자세한 설명은 예외 필터와 기존 예외 처리를 참조하세요.

다음 예제에서는 키워드를 when 사용하여 예외 메시지의 텍스트에 따라 처리기를 HttpRequestException 조건부로 실행합니다.

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;
        }
    }
}

참고하십시오

• C# 키워드