Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Metodo

Definizione

Spazio dei nomi:
Microsoft.IE
Assembly:
IEHost.dll

Converte una stringa URL in formato canonico.

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 con terminazione Null di lunghezza massima (INTERNET_MAX_URL_LENGTH) che contiene una stringa 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 la modalità di conversione dell'URL in formato canonico. È possibile combinare i flag seguenti:

  • Manager.URL_CANONFLAGS: trattare "/./" e "/.. /" in una stringa URL come caratteri letterali, non come abbreviato per la navigazione.

  • Manager.URL_CANONFLAGS: converte qualsiasi occorrenza di "%" nella sequenza di escape.

  • Manager.URL_CANONFLAGS: sostituire 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: sostituire i caratteri non sicuri con le relative sequenze di escape. I caratteri non sicuri sono caratteri che possono essere modificati durante il trasporto attraverso Internet. Includono i <caratteri , >, ", #, {, }, |, \, ^, [, ]e ' . Questo flag si applica a tutti gli URL, inclusi gli URL opachi.

  • Manager.URL_CANONFLAGS: definito come uguale Manager.URL_CANONFLAGSa .

  • Manager.URL_CANONFLAGS: combinare GLI URL con protocolli collegabili definiti dal client, in base alla specifica W3C (World Wide Web Consortium). Questo flag non si applica ai protocolli standard, ad esempio FTP, HTTP e Gopher. Se questo flag è impostato, non è necessario impostare Manager.URL_CANONFLAGSanche .

  • Manager.URL_CANONFLAGS: annulla l'escape di tutte le sequenze di escape contenute negli URL, con due eccezioni. Le sequenze di escape per "?" e "#" non sono senza escape. Se viene impostato anche uno dei flag di URL_ESCAPE, i due URL vengono prima senza caratteri di escape, quindi combinati e quindi preceduti da un carattere di escape.

Valori restituiti

String

URL canonizzato.

Si applica a