Uri.EscapeUriString(String) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

UriExt.cs

Precaución

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

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

public:
 static System::String ^ EscapeUriString(System::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 instead.", 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 a la que se van a aplicar secuencias de escape.

Devoluciones

String

Representación de escape de stringToEscape.

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

stringToEscape es null.

UriFormatException

La longitud de stringToEscape supera los 32 766 caracteres.

    Note: In <a href="https://docs.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://docs.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</a>, catch the base class exception, <xref data-throw-if-not-resolved="true" uid="System.FormatException"></xref>, instead.

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 RFC 2396 no reservados, 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, en 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.

De forma predeterminada, la cadena se escapa según RFC 2396. Si el análisis de identificadores de recursos internacionales (IRIs) o el análisis 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 .