Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將 URL 字串轉換成標準格式。
此 API 支援此產品基礎結構,但無法直接用於程式碼之中。
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
參數
- pURL
- String
最大長度 (INTERNET_MAX_URL_LENGTH) 的 Null 結尾字串,包含 URL 字串。 若字串並非指向檔案,則必須包含有效的配置 (例如 "http://")。
- flags
- Manager.URL_CANONFLAGS
指定 URL 轉換成標準格式方式的旗標。 下列旗標可以合併使用:
Manager.URL_CANONFLAGS:將 URL 字串中的 "/./" 和 "/../" 作為常值字元處理,而非導覽的速記。
Manager.URL_CANONFLAGS:將任何出現的 "%" 轉換成其逸出序列。
Manager.URL_CANONFLAGS:僅將空格取代為逸出序列。 此旗標會優先於 Manager.URL_CANONFLAGS,但不會套用到不透明 URL。
Manager.URL_CANONFLAGS:將 Unsafe 字元取代為其逸出序列。 Unsafe 字元是可能會在透過網際網路傳輸期間遭到改變的字元。 它們包括 < 、 > 、、、#、{、}、|、\、^、[、]和 ' 字元。 此旗標適用於所有 URL,包括不透明 URL。
Manager.URL_CANONFLAGS:根據全球資訊網協會 (W3C) 規格,將 URL 與用戶端定義的插入式通訊協定合併。 此旗標不會套用到標準通訊協定 (例如 FTP、HTTP 與 Gopher)。 若設定此旗標,則不需要同時設定 Manager.URL_CANONFLAGS。
Manager.URL_CANONFLAGS:將 URL 包含的任何逸出序列取消逸出,除了以下兩種情況。 "?" 和 "#" 的逸出序列不會取消逸出。 若已設定其中一個 URL_ESCAPE 旗標,則會先取消逸出兩個 URL,然後合併之後再逸出。
傳回
規範化 URL。