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,但不適用於不透明的網址。
Manager.URL_CANONFLAGS:替換不安全的逃脫角色。 不安全字元是指在網路傳輸過程中可能被更改的字元。 它們包含 <、 >、 “、#、{, }、|、\、^、[, ], 和 ' 字元。 此旗標適用於所有網址,包括不透明的網址。
Manager.URL_CANONFLAGS:根據萬維網聯盟(W3C)規範,將網址與客戶端定義的可插拔協定結合。 此旗標不適用於標準協定,如 FTP、HTTP 和 Gopher。 如果此標誌已設定,則無需同時設定 Manager.URL_CANONFLAGS。
Manager.URL_CANONFLAGS:將網址中包含的任何逃脫序列(有兩個例外)取消逃脫。 「?」和「#」的逃脫序列並非未逃脫。 如果同時設定URL_ESCAPE旗標,兩個 URL 先是未跳脫,然後合併,最後再逃脫。
傳回
標準化網址。