Uri.EscapeUriString(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> stringPublic Shared Function EscapeUriString (stringToEscape As String) As StringPará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 .
