Uri.GetComponents(UriComponents, UriFormat) 메서드

정의

특수 문자에 지정된 이스케이프를 사용하여 현재 인스턴스에 지정된 구성 요소를 가져옵니다.Gets the specified components of the current instance using the specified escaping for special characters.

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 값의 비트 조합입니다.A bitwise combination of the UriComponents values that specifies which parts of the current instance to return to the caller.

format
UriFormat

특수 문자가 이스케이프되는 방법을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls how special characters are escaped.

반환

String

현재 인스턴스의 구성 요소입니다.The components of the current instance.

예외

components가 유효한 UriComponents 값의 조합이 아닌 경우components is not a combination of valid UriComponents values.

현재 Uri가 절대 URI가 아닌 경우.The current Uri is not an absolute URI. 상대 URI는 이 메서드에서 사용할 수 없습니다.Relative URIs cannot be used with this method.

설명

,,,,, Query Fragment Scheme UserInfo Host PortPath 구성 요소는 구분 기호를 포함 하지 않습니다.The Query, Fragment, Scheme, UserInfo, Host, Port, and Path components do not include the delimiter. KeepDelimiter비트 or 연산자를 사용 하 여 플래그를 이러한 값과 결합 하 여 구분 기호를 사용 하 여 값을 가져올 수 있습니다.You can combine the KeepDelimiter flag (using the bitwise OR operator) with any of those values to get the value with the delimiter. 다른 모든 UriComponents 값 및 값 조합의 경우 반환 된 값에 구분 기호가 포함 됩니다.For all other UriComponents values, and combinations of values, the delimiters are included in the returned value.

구성 요소는 URI에 표시 되는 순서 대로 반환 됩니다.The components are returned in the order that they appear in the URI. 예를 들어 Scheme 가 지정 된 경우이는 먼저 표시 됩니다.For example, if Scheme is specified, it appears first.

IRI (국제 리소스 식별자) 및 IDN (다국어 도메인 이름) 지원을 사용 하는 경우에서 반환 되는 문자 수가 String 늘어납니다.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, the number of characters returned in the String increases. IRI를 지 원하는 데 사용 되는 Punycode 이름에는 ASCII 문자만 포함 되며 항상 xn--접두사로 시작 합니다.Punycode names used to support IRI contain only ASCII characters and always start with the xn-- prefix. IRI 및 IDN을 사용 하도록 설정 하면 메서드에서 유니코드 서로게이트 문자를 올바르게 처리 GetComponents 합니다.When IRI and IDN are enabled, Unicode surrogate characters are handled correctly by the GetComponents method.

IRI 지원에 대 한 자세한 내용은 클래스에 대 한 설명 섹션을 참조 하세요 Uri .For more information on IRI support, see the Remarks section for the Uri class.

참고

GetComponents을로 설정 하 여 메서드를 호출 하는 경우 format Unescaped 반환 값을 생성자에 대 한 인수로 사용 Uri 하 여 해당 하는을 만들 수 없습니다 Uri .If the GetComponents method is called with format set to Unescaped , you cannot use the return value as an argument to a Uri constructor to create an equivalent Uri.

적용 대상