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

Définition

Espace de noms:
Microsoft.IE
Assembly:
IEHost.dll

Convertit une chaîne d’URL sous forme canonique.

Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code.

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

Paramètres

pURL
String

Chaîne terminée par null de longueur maximale (INTERNET_MAX_URL_LENGTH) qui contient une chaîne d’URL. Si la chaîne ne fait pas référence à un fichier, elle doit inclure un schéma valide tel que « http:// ».

flags
Manager.URL_CANONFLAGS

Indicateurs qui spécifient la façon dont l’URL sera convertie en forme canonique. Les indicateurs suivants peuvent être combinés :

  • Manager.URL_CANONFLAGS: Traiter « /./ » et « /.. /" dans une chaîne d’URL en tant que caractères littéraux, pas comme raccourci pour la navigation.

  • Manager.URL_CANONFLAGS: convertissez toute occurrence de «%» en séquence d’échappement.

  • Manager.URL_CANONFLAGS: remplacez uniquement les espaces par des séquences d’échappement. Cet indicateur est prioritaire Manager.URL_CANONFLAGS, mais ne s’applique pas aux URL opaques.

  • Manager.URL_CANONFLAGS: remplacez les caractères non sécurisés par leurs séquences d’échappement. Les caractères non sécurisés sont des caractères qui peuvent être modifiés pendant le transport sur Internet. Ils incluent les <caractères « , >« , #, {, }, |, \, ^, [, ], et ». Cet indicateur s’applique à toutes les URL, y compris les URL opaques.

  • Manager.URL_CANONFLAGS: défini comme étant identique à Manager.URL_CANONFLAGS.

  • Manager.URL_CANONFLAGS: combinez des URL avec des protocoles enfichables définis par le client, conformément à la spécification W3C (World Wide Web Consortium). Cet indicateur ne s’applique pas aux protocoles standard tels que FTP, HTTP et Gopher. Si cet indicateur est défini, il n’est pas nécessaire de définir Manager.URL_CANONFLAGSégalement .

  • Manager.URL_CANONFLAGS: Annulez les séquences d’échappement que les URL contiennent, avec deux exceptions. Les séquences d’échappement pour « ? » et « # » ne sont pas non échapées. Si l’un des indicateurs URL_ESCAPE est également défini, les deux URL sont d’abord non échapées, puis combinées, puis échappées.

Retours

String

URL canonique.

S’applique à