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

Definición

Espacio de nombres:

Microsoft.IE

Ensamblado:

IEHost.dll

Convierte una cadena de dirección URL al 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 va a convertir la dirección URL al 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 abreviatura de navegación.

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

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

• Manager.URL_CANONFLAGS: definido para ser igual que Manager.URL_CANONFLAGS.

• Manager.URL_CANONFLAGS: combina direcciones URL con protocolos acoplables definidos por el cliente, según la especificación de World Wide Web Consortium (W3C). Esta marca no se aplica a protocolos estándar como FTP, HTTP y Gopher. Si esta marca está establecida, no hay necesidad de establecer también Manager.URL_CANONFLAGS.

• Manager.URL_CANONFLAGS: elimina el escape de las secuencias de escape que contienen las direcciones URL, con dos excepciones. No se elimina el escape de las secuencias de escape de "?" y "#". Si también hay establecida alguna de las marcas URL_ESCAPE, primero se elimina el escape de las dos direcciones URL, se combinan y luego se aplica el escape.

Devoluciones

String

Dirección URL con formato canónico.