Compartir a través de


Uri.EscapeUriString(String) Método

Definición

Precaución

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

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);
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);
[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);
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
[<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

Representación de escape de stringToEscape.

Atributos

Excepciones

stringToEscape es null.

La longitud de stringToEscape supera los 32 766 caracteres.

    Note: In <a href="https://learn.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://learn.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 .

Se aplica a