Partager via

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

  • Référence

Définition

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

Convertit une chaîne d’URL en 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

Une chaîne se terminant 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 vers sa forme canonique. Les indicateurs suivants peuvent être combinés :

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

  • Manager.URL_CANONFLAGS : Convertissez toute occurrence de « % » vers sa séquence d’échappement.

  • Manager.URL_CANONFLAGS : Remplacez uniquement les espaces par des séquences d’échappement. Cet indicateur est prioritaire sur 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 leur transport sur Internet. Ils incluent les <caractères , >, #, {, }, |, \, ^, [, ] et ' . Cet indicateur s’applique à toutes les URL, y compris aux URL opaques.

  • Manager.URL_CANONFLAGS : Défini pour être le même que Manager.URL_CANONFLAGS.

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

  • Manager.URL_CANONFLAGS : Annulez toutes les séquences d’échappement que les URL contiennent, à deux exceptions près. Les séquences d’échappement pour « ? » et « # » ne sont pas annulées. Si l’un des indicateurs URL_ESCAPE est également défini, les deux URL sont tout d’abord modifiées pour ne pas comporter de séquence d’échappement, puis pour comporter des séquences d’échappement.

Retours

String

URL rendue canonique.

S’applique à