Lenguaje

Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Método

Definición

Convierte una cadena de dirección URL en formato canónico.

Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código.

public:
 static System::String ^ CanonizeURL(System::String ^ pURL, Microsoft::IE::Manager::URL_CANONFLAGS flags);
public static string CanonizeURL(string pURL, Microsoft.IE.Manager.URL_CANONFLAGS flags);
static member CanonizeURL : string * Microsoft.IE.Manager.URL_CANONFLAGS -> string
Public Shared Function CanonizeURL (pURL As String, flags As Manager.URL_CANONFLAGS) As String

Parámetros

pURL
String

Cadena terminada en null de longitud máxima (INTERNET_MAX_URL_LENGTH) que contiene una cadena de dirección URL. Si la cadena no hace referencia a un archivo, debe incluir un esquema válido como "http://".

flags
Manager.URL_CANONFLAGS

Marcas que especifican cómo se convertirá la dirección URL en formato canónico. Se pueden combinar las marcas siguientes:

  • Manager.URL_CANONFLAGS: trata "/./" y "/.. /" en una cadena de dirección URL como caracteres literales, no como abreviada para la navegación.

  • Manager.URL_CANONFLAGS: convierte cualquier aparición de "%" en su secuencia de escape.

  • Manager.URL_CANONFLAGS: reemplace solo los espacios por secuencias de escape. Esta marca tiene prioridad sobre Manager.URL_CANONFLAGS, pero no se aplica a direcciones URL opacas.

  • Manager.URL_CANONFLAGS: reemplace caracteres no seguros por sus secuencias de escape. Los caracteres no seguros son caracteres que se pueden modificar durante el transporte a través de Internet. Incluyen los <caracteres , >, ", ", #, {, }, |, \, ^, [, ] y ' . Esta marca se aplica a todas las direcciones URL, incluidas las direcciones URL opacas.

  • Manager.URL_CANONFLAGS: se define para que sea igual Manager.URL_CANONFLAGSque .

  • Manager.URL_CANONFLAGS: combine direcciones URL con protocolos conectables definidos por el cliente, según la especificación world Wide Web Consortium (W3C). Esta marca no se aplica a protocolos estándar como FTP, HTTP y Gopher. Si se establece esta marca, no es necesario establecer Manager.URL_CANONFLAGStambién .

  • Manager.URL_CANONFLAGS: unescape cualquier secuencia de escape que contengan las direcciones URL, con dos excepciones. Las secuencias de escape de "?" y "#" no están sin escape. Si también se establece una de las marcas de URL_ESCAPE, las dos direcciones URL se descapitan primero y, a continuación, se combinan y luego se escapan.

Devoluciones

Dirección URL canónica.

Se aplica a