다음을 통해 공유


Uri.EscapeComponent(String) 메서드

정의

URI(Uniform Resource Identifier) 문자열을 이스케이프된 표현으로 변환합니다.

public:
 static Platform::String ^ EscapeComponent(Platform::String ^ toEscape);
 static winrt::hstring EscapeComponent(winrt::hstring const& toEscape);
public static string EscapeComponent(string toEscape);
function escapeComponent(toEscape)
Public Shared Function EscapeComponent (toEscape As String) As String

매개 변수

toEscape
String

Platform::String

winrt::hstring

변환할 문자열입니다.

반환

String

Platform::String

winrt::hstring

toEscape의 이스케이프된 표현입니다.

설명

EscapeComponent를 유틸리티로 사용하여 유효한 Uri 개체를 생성하기 위해 이스케이프해야 하는 URI (Uniform Resource Identifier) 구성 요소를 이스케이프합니다. 예를 들어 앱이 사용자 제공 문자열을 사용하여 서비스로 전송되는 쿼리에 추가하는 경우 문자열에 URI(Uniform Resource Identifier)에 잘못된 문자가 포함될 수 있으므로 URI(Uniform Resource Identifier)에서 해당 문자열을 이스케이프해야 할 수 있습니다. 여기에는 공백만큼 간단한 문자가 포함됩니다. 순수 ASCII인 것처럼 보이는 입력도 인코딩이 URI(Uniform Resource Identifier)의 구성 요소로 유효해야 할 수 있습니다.

Uri(String) 생성자를 호출하기 전에 EscapeComponent에서 가져오는 문자열을 다른 문자열에 추가할 수 있습니다. Uri(String) 생성자가 문자열을 호스트와 경로 사이의 "/" 또는 경로와 쿼리 사이의 "?"와 같은 구성 요소로 구문 분석하는 방법에 중요한 문자를 이스케이프하지 않기 때문에 각 구성 요소를 개별적으로 인코딩하려고 합니다.

EscapeComponent는 Windows.Web.Http 네임스페이스의 API 사용과 같은 HTTP 요청 시나리오에 URI(Uniform Resource Identifier) 이스케이프 문자열이 필요한 다른 시나리오에도 유용할 수 있습니다.

적용 대상

추가 정보