Uri.EscapeUriString(String) Método

Definición

Espacio de nombres:
System
Ensamblados:
System.dll, System.Runtime.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs

Precaución

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.

Precaución

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.

Convierte una cadena de URI en su representación con escape.

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString(string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString(string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString(string stringToEscape);
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (stringToEscape As String) As String

Parámetros

stringToEscape
String

Cadena con caracteres de escape.

Devoluciones

String

Representación con escape de stringToEscape.

Atributos
ObsoleteAttribute

Excepciones

ArgumentNullException

stringToEscape es null.

UriFormatException

solo .NET Framework: la longitud de stringToEscape supera los 32766 caracteres.

Comentarios

Use el EscapeUriString método para preparar una cadena de URI sin escape para que sea un parámetro para el Uri constructor.

De forma predeterminada, el EscapeUriString método convierte todos los caracteres, excepto los caracteres no reservados RFC 2396, en su representación hexadecimal. Si el análisis de identificadores de recursos internacionales (IRIs) o el análisis de nombres de dominio internacionalizados (IDN) está habilitado, el EscapeUriString método convierte todos los caracteres, excepto los caracteres RFC 3986 no reservados, a su representación hexadecimal. Todos los caracteres Unicode se convierten en formato UTF-8 antes de que se escapen.

Este método supone que stringToEscape no tiene secuencias de escape en él.

De forma predeterminada, la cadena se escapa según RFC 2396. Si el análisis de identificadores de recursos internacionales (IRIs) o de nombres de dominio internacionalizados (IDN) está habilitado, la cadena se escapa según RFC 3986 y RFC 3987. Consulte estas RFC para obtener una definición de caracteres reservados y no reservados.

Para obtener más información sobre la compatibilidad con IRI, vea la sección Comentarios de la Uri clase .

Se aplica a