Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Methode

Definition

Konvertiert eine URL-Zeichenfolge in kanonische Form.

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

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

Parameter

pURL
String

Eine null-beendete Zeichenfolge mit maximaler Länge (INTERNET_MAX_URL_LENGTH), die eine URL-Zeichenfolge enthält. Wenn die Zeichenfolge nicht auf eine Datei verweist, muss sie ein gültiges Schema wie "http://" enthalten.

flags
Manager.URL_CANONFLAGS

Die Flags, die angeben, wie die URL in kanonische Form konvertiert wird. Die folgenden Flags können kombiniert werden:

  • Manager.URL_CANONFLAGS: Behandeln Sie "/./" und "/.. /" in einer URL-Zeichenfolge als Literalzeichen, nicht als Abkürzung für die Navigation.

  • Manager.URL_CANONFLAGS: Wandeln Sie jedes Vorkommen von "%" in die Escapesequenz um.

  • Manager.URL_CANONFLAGS: Ersetzen Sie nur Leerzeichen durch Escapesequenzen. Dieses Kennzeichen hat Vorrang Manager.URL_CANONFLAGS, gilt jedoch nicht für undurchsichtige URLs.

  • Manager.URL_CANONFLAGS: Ersetzen Sie unsichere Zeichen durch ihre Escapesequenzen. Unsichere Zeichen sind Zeichen, die während des Transports im Internet geändert werden können. Sie enthalten die <Zeichen " >, ", #, {, }, |, \, ^, [, ], und '. Dieses Flag gilt für alle URLs, einschließlich undurchsichtiger URLs.

  • Manager.URL_CANONFLAGS: Definiert als identisch mit Manager.URL_CANONFLAGS.

  • Manager.URL_CANONFLAGS: Kombinieren Sie URLs mit clientdefiniert austauschbaren Protokollen gemäß der Spezifikation des World Wide Web Consortium (W3C). Dieses Flag gilt nicht für Standardprotokolle wie FTP, HTTP und Gopher. Wenn dieses Kennzeichen festgelegt ist, muss nicht auch festgelegt Manager.URL_CANONFLAGSwerden.

  • Manager.URL_CANONFLAGS: Entfernen Sie alle Escapesequenzen, die die URLs enthalten, mit zwei Ausnahmen. Die Escapesequenzen für "?" und "#" sind nicht unescaped. Wenn auch eine der URL_ESCAPE Flags festgelegt ist, werden die beiden URLs zuerst nicht gescapet, dann kombiniert und dann escaped.

Gibt zurück

Die kanonische URL.

Gilt für: