C# Uri.CheckSchemeName() 메서드 완벽 가이드: URI 스킴 이름 유효성 검사하기

C#에서 Uri.CheckSchemeName() 메서드는 지정된 스킴(scheme) 이름이 유효한지 여부를 판별하는 데 사용됩니다. URI를 다룰 때 스킴 이름이 올바른 형식인지 사전에 검증해야 하는 경우에 유용하게 활용할 수 있습니다.

문법

이 메서드의 기본 문법은 다음과 같습니다.

public static bool CheckSchemeName (string schemeName);

매개변수 schemeName은 유효성을 검사할 스킴 이름을 나타냅니다. 검사 결과가 유효하면 true, 그렇지 않으면 false를 반환하는 정적(static) 메서드입니다.

예제 1: 기본 사용법

먼저, Uri.CheckSchemeName() 메서드를 구현한 간단한 예제를 살펴보겠습니다.

using System;
public class Demo {
    public static void Main(){
        Uri newURI = new Uri("https://www.tutorialspoint.com");
        Console.WriteLine("URI = "+newURI);
        string schemeName = newURI.Scheme;
        if(Uri.CheckSchemeName(schemeName))
            Console.WriteLine("Valid: Scheme name");
        else
            Console.WriteLine("Invalid: Scheme name");
    }
}

출력 결과

위 코드를 실행하면 다음과 같은 결과가 출력됩니다.

URI = https://www.tutorialspoint.com/
Valid: Scheme name

이 예제에서는 https라는 스킴 이름을 추출하여 CheckSchemeName()으로 검증했습니다. https는 유효한 스킴 이름이므로 "Valid" 메시지가 출력되었습니다.

예제 2: 경로가 포함된 URI 검사

이번에는 파일 경로가 포함된 URI로 동일한 메서드를 구현해 보겠습니다.

using System;
public class Demo {
    public static void Main(){
        Uri newURI = new Uri("https://www.tutorialspoint.com/index.htm");
        Console.WriteLine("URI = "+newURI);
        string schemeName = newURI.Scheme;
        if(Uri.CheckSchemeName(schemeName))
            Console.WriteLine("Valid: Scheme name");
        else
            Console.WriteLine("Invalid: Scheme name");
    }
}

출력 결과

위 코드를 실행하면 다음과 같은 결과가 출력됩니다.

URI = https://www.tutorialspoint.com/index.htm
Valid: Scheme name

URI에 경로(/index.htm)가 포함되어 있어도 스킴 이름은 여전히 https이므로 유효하다고 판단됩니다. 이처럼 CheckSchemeName()은 URI 전체가 아닌 스킴 부분만 검사한다는 점을 기억하면 좋습니다.

참고 사항

유효한 스킴 이름은 일반적으로 알파벳 문자로 시작해야 하며, 이후에는 알파벳, 숫자, 마침표(.), 하이픈(-), 더하기(+) 기호를 포함할 수 있습니다. 또한 .NET 5 이상 버전에서는 이 메서드가 항상 true를 반환하도록 변경되었으므로, 최신 버전의 .NET을 사용하는 경우 이 점을 유의해야 합니다.