Freigeben über

Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Methode

  • Referenz

Definition

Namespace:
Microsoft.IE
Assembly:
IEHost.dll

Konvertiert eine URL-Zeichenfolge in ein kanonisches Format.

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 auf NULL endende Zeichenfolge der maximalen Länge (INTERNET_MAX_URL_LENGTH), die eine URL-Zeichenfolge enthält. Wenn die Zeichenfolge nicht auf eine Datei verweist, muss diese ein gültiges Schema wie „http://“ enthalten.

flags
Manager.URL_CANONFLAGS

Das Flag, das angibt, wie die URL in ein kanonisches Format konvertiert wird. Die folgenden Flags können kombiniert werden:

  • Manager.URL_CANONFLAGS: Behandelt „/./“ and „/../“ in einer URL-Zeichenfolge als literale Zeichen anstatt als Kurzformen für die Navigation.

  • Manager.URL_CANONFLAGS: Konvertiert „%“ immer in die entsprechende Escapesequenz.

  • Manager.URL_CANONFLAGS: Ersetzt nur Leerzeichen durch Escapesequenzen. Dieses Flag hat gegenüber Manager.URL_CANONFLAGS Vorrang, gilt aber nicht für opake URLs.

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

  • Manager.URL_CANONFLAGS: Soll Manager.URL_CANONFLAGS entsprechen.

  • Manager.URL_CANONFLAGS: Kombiniert anhand der World Wide Web Consortium-Spezifikation (W3C) URLs mit vom Client definierten austauschbaren Protokollen. Dieses Flag gilt nicht für Standardprotokolle wie FTP, HTTP und Gopher. Wenn dieses Flag festgelegt ist, muss auch Manager.URL_CANONFLAGS festgelegt sein.

  • Manager.URL_CANONFLAGS: Entfernt alle Escapezeichen für ausnahmslos alle Escapesequenzen, die die URLs beinhalten. Die Escapezeichen für die Escapesequenzen für „?“ und „#“ wurden nicht entfernt. Wenn auch eins der URL_ESCAPE-Flags festgelegt ist, werden die Escapezeichen für die beiden URLs erst entfernt und anschließend kombiniert. Danach werden wieder Escapezeichen hinzugefügt.

Gibt zurück

String

Die kanonische URL.

Gilt für: