Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Metodo

Definizione

Spazio dei nomi:

Microsoft.IE

Assembly:

IEHost.dll

Converte una stringa dell'URL in forma canonica.

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

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

Parametri

pURL

String

Stringa di lunghezza massima con terminazione Null (INTERNET_MAX_URL_LENGTH) contenente una stringa dell'URL. Se la stringa non fa riferimento a un file, deve includere uno schema valido, ad esempio "http://".

flags

Manager.URL_CANONFLAGS

Flag che specificano come l'URL verrà convertito in forma canonica. È possibile combinare i flag seguenti:

• Manager.URL_CANONFLAGS: considera "/./" e "/../" in una stringa dell'URL come caratteri letterali, non come sintassi abbreviata per lo spostamento.

• Manager.URL_CANONFLAGS: converte tutte le occorrenze di "%" nella rispettiva sequenza di escape.

• Manager.URL_CANONFLAGS: sostituisce solo gli spazi con sequenze di escape. Questo flag ha la precedenza su Manager.URL_CANONFLAGS, ma non si applica agli URL opachi.

• Manager.URL_CANONFLAGS: sostituisce i caratteri non sicuri con le rispettive sequenze di escape. Non sono sicuri i caratteri che possono essere modificati durante il trasporto in Internet, Includono i <caratteri , , >", #, {, }, |, \, ^, [, ]e ' . Questo flag si applica a tutti gli URL, inclusi gli URL opachi.

• Manager.URL_CANONFLAGS: viene definito in modo che sia uguale a Manager.URL_CANONFLAGS.

• Manager.URL_CANONFLAGS: combina gli URL con protocolli di collegamento definiti dal client, in base alla specifica del World Wide Web Consortium (W3C). Questo flag non si applica ai protocolli standard, ad esempio FTP, HTTP e Gopher. Se si imposta questo flag, non è necessario impostare anche Manager.URL_CANONFLAGS.

• Manager.URL_CANONFLAGS: rimuove la sequenza escape da tutte le sequenze di escape contenute negli URL, con due eccezioni. Non viene rimossa la sequenza escape per "?" e "#". Se viene impostato anche uno dei flag URL_ESCAPE, prima viene rimossa la sequenza escape dei due URL, poi i due URL vengono combinati e infine viene aggiunto il carattere di escape agli URL.

Restituisce

String

URL in forma canonica.