Uri.EscapeUriString(String) Uri.EscapeUriString(String) Uri.EscapeUriString(String) Uri.EscapeUriString(String) Method

Definición

Convierte una cadena URI en su representación con secuencias de escape.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

Parámetros

stringToEscape
String String String String

Cadena a la que se van a aplicar secuencias de escape.The string to escape.

Devoluciones

String que contiene la representación de escape de stringToEscape.A String that contains the escaped representation of stringToEscape.

Excepciones

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

La longitud de stringToEscape supera los 32 766 caracteres.The length of stringToEscape exceeds 32766 characters.

Comentarios

Use el método EscapeUriString para preparar una cadena de URI sin escape como parámetro para el constructor Uri.Use the EscapeUriString method to prepare an unescaped URI string to be a parameter to the Uri constructor.

De forma predeterminada, el método EscapeUriString convierte todos los caracteres, excepto los caracteres no reservados RFC 2396, en su representación hexadecimal.By default, the EscapeUriString method converts all characters, except RFC 2396 unreserved characters, to their hexadecimal representation. Si el análisis de los identificadores de recursos internacionales (IRIs) o de nombres de dominio internacionalizados (IDN) está habilitado, el método EscapeUriString convierte todos los caracteres, excepto los caracteres no reservados de RFC 3986, a su representación hexadecimal.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. Todos los caracteres Unicode se convierten al formato UTF-8 antes de que se escapen.All Unicode characters are converted to UTF-8 format before being escaped.

Este método supone que stringToEscape no tiene secuencias de escape en él.This method assumes that stringToEscape has no escape sequences in it.

De forma predeterminada, la cadena se convierte en un carácter de escape según RFC 2396.By default, the string is escaped according to RFC 2396. Si el análisis de los identificadores de recursos internacionales (IRIs) o de nombres de dominio internacionalizados (IDN) está habilitado, la cadena se convierte en un carácter de escape según RFC 3986 y 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. Vea estas RFC para obtener una definición de caracteres reservados y no reservados.See these RFCs for a definition of reserved and unreserved characters.

Para obtener más información sobre la compatibilidad con IRI, consulte la sección Comentarios de la clase Uri.For more information on IRI support, see the Remarks section for the Uri class.

Se aplica a