Uri.GetComponents(UriComponents, UriFormat) 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

어셈블리:

System.dll

어셈블리:

netstandard.dll

특수 문자에 지정된 이스케이프를 사용하여 현재 인스턴스에 지정된 구성 요소를 가져옵니다.

public:
 System::String ^ GetComponents(UriComponents components, UriFormat format);

public string GetComponents (UriComponents components, UriFormat format);

member this.GetComponents : UriComponents * UriFormat -> string

Public Function GetComponents (components As UriComponents, format As UriFormat) As String

매개 변수

components

UriComponents

호출자에게 반환할 현재 인스턴스 부분을 지정하는 UriComponents 값의 비트 조합입니다.

format

UriFormat

특수 문자가 이스케이프되는 방법을 제어하는 열거형 값 중 하나입니다.

반환

String

현재 인스턴스의 구성 요소입니다.

예외

ArgumentOutOfRangeException

components가 유효한 UriComponents 값의 조합이 아닌 경우

InvalidOperationException

현재 Uri가 절대 URI가 아닌 경우. 상대 URI는 이 메서드에서 사용할 수 없습니다.

설명

Query, Fragment, Scheme, UserInfo, HostPort및 Path 구성 요소에는 구분 기호가 포함되지 않습니다. 플래그(비트 OR 연산자 사용)를 해당 값과 결합하여 KeepDelimiter 구분 기호로 값을 가져올 수 있습니다. 다른 UriComponents 모든 값 및 값 조합의 경우 구분 기호가 반환된 값에 포함됩니다.

구성 요소는 URI에 표시되는 순서대로 반환됩니다. 예를 들어 지정된 경우 Scheme 먼저 나타납니다.

IRI(International Resource Identifier) 및 IDN(Internationalized Domain Name) 지원을 사용하도록 설정하면 반환 String 되는 문자 수가 증가합니다. IRI를 지원하는 데 사용되는 Punycode 이름은 ASCII 문자만 포함하며 항상 xn-- 접두사로 시작합니다. IRI 및 IDN을 사용하도록 설정하면 유니코드 서로게이트 문자가 메서드에 GetComponents 의해 올바르게 처리됩니다.

IRI 지원에 대한 자세한 내용은 클래스의 설명 섹션을 Uri 참조하세요.

참고

이 메서드가 GetComponents set to로 Unescaped 설정된 상태에서 호출 format 되는 경우 반환 값을 생성자에 대한 인수 Uri 로 사용하여 동등한 Uri값을 만들 수 없습니다.