Uri.EscapeComponent(String) Método

Definición

Convierte una cadena de identificador uniforme de recursos (URI) en su representación con escape.

public:
 static Platform::String ^ EscapeComponent(Platform::String ^ toEscape);
 static winrt::hstring EscapeComponent(winrt::hstring const& toEscape);
public static string EscapeComponent(string toEscape);
function escapeComponent(toEscape)
Public Shared Function EscapeComponent (toEscape As String) As String

Parámetros

toEscape
String

Platform::String

winrt::hstring

Cadena que se va a convertir.

Devoluciones

String

Platform::String

winrt::hstring

Representación con escape de toEscape.

Comentarios

Use EscapeComponent como utilidad para escapar de cualquier componente de identificador uniforme de recursos (URI) que requiera escape para construir un objeto URI válido. Por ejemplo, si la aplicación usa una cadena proporcionada por el usuario y la agrega a una consulta que se envía a un servicio, es posible que tenga que escapar esa cadena en el identificador uniforme de recursos (URI) porque la cadena podría contener caracteres que no son válidos en un identificador uniforme de recursos (URI). Esto incluye caracteres tan simples como espacios; Incluso la entrada que parece ser ASCII pura puede seguir necesitando codificación para que sea válida como componente de un identificador uniforme de recursos (URI).

Puede anexar la cadena que obtiene de EscapeComponent a otras cadenas antes de llamar al constructor Uri(String). Querrá codificar cada componente por separado, ya que no desea escapar los caracteres que son significativos para cómo el constructor Uri(String) analiza la cadena en componentes, como "/" entre el host y la ruta de acceso o "?" entre la ruta de acceso y la consulta.

EscapeComponent también puede ser útil para otros escenarios en los que se necesita una cadena de escape de identificador uniforme de recursos (URI) para un escenario de solicitud HTTP, como el uso de API en el espacio de nombres Windows.Web.Http .

Se aplica a

Consulte también