Uri.EscapeUriString(String) 메서드

정의

URI 문자열을 이스케이프된 표현으로 변환합니다.Converts a URI string to its escaped representation.

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString (string stringToEscape);
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (stringToEscape As String) As String

매개 변수

stringToEscape
String

이스케이프할 문자열입니다.The string to escape.

반환

String

stringToEscape에 대해 이스케이프된 표현입니다.The escaped representation of stringToEscape.

예외

stringToEscape이(가) null인 경우stringToEscape is null.

참고: Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 FormatException을 catch합니다.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

stringToEscape의 길이가 32766자를 초과하는 경우The length of stringToEscape exceeds 32766 characters.

설명

Use the <xref:System.Uri.EscapeUriString%2A> method to prepare an unescaped URI string to be a parameter to the <xref:System.Uri.%23ctor%2A> constructor.

기본적으로 메서드는 EscapeUriString RFC 2396 예약 되지 않은 문자를 제외한 모든 문자를 16 진수 표현으로 변환 합니다.By default, the EscapeUriString method converts all characters, except RFC 2396 unreserved characters, to their hexadecimal representation. Iri (국제 리소스 식별자) 또는 IDN (다국어 도메인 이름) 구문 분석이 사용 하도록 설정 된 경우이 EscapeUriString 메서드는 RFC 3986 예약 되지 않은 문자를 제외한 모든 문자를 16 진수 표현으로 변환 합니다.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the EscapeUriString method converts all characters, except for RFC 3986 unreserved characters, to their hexadecimal representation. 모든 유니코드 문자는 이스케이프 되기 전에 UTF-8 형식으로 변환 됩니다.All Unicode characters are converted to UTF-8 format before being escaped.

이 메서드는에 stringToEscape 이스케이프 시퀀스가 없는 것으로 가정 합니다.This method assumes that stringToEscape has no escape sequences in it.

기본적으로이 문자열은 RFC 2396에 따라 이스케이프 됩니다.By default, the string is escaped according to RFC 2396. Iri (국제 리소스 식별자) 또는 IDN (다국어 도메인 이름) 구문 분석이 사용 하도록 설정 된 경우에는 RFC 3986 및 RFC 3987에 따라 문자열이 이스케이프 됩니다.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is escaped according to RFC 3986 and RFC 3987. 예약 된 문자와 예약 되지 않은 문자에 대 한 정의는 다음 Rfc를 참조 하세요.See these RFCs for a definition of reserved and unreserved characters.

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

적용 대상