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

长度最长 (INTERNET_MAX_URL_LENGTH) 的以 NULL 结尾且包含 URL 字符串的字符串。如果字符串不引用文件，则它必须包含“http://”等有效的方案。

指定如何将 URL 转换为规范格式的标志。可以组合下列标志：

Manager.URL_CANONFLAGS：将 URL 字符串中的“/./”和“/../”视为文本字符，而不是导航的简写。
Manager.URL_CANONFLAGS：将出现的所有“%”转换为其转义序列。
Manager.URL_CANONFLAGS：只用转义序列替换空格。此标志优先于 Manager.URL_CANONFLAGS，但不适用于非跳转 URL。
Manager.URL_CANONFLAGS：用转义序列替换不安全字符。不安全字符是在 Internet 传输过程中可能会更改的字符。它们包括 <、 >、“、#、{、}、|、\、^、[、]和 ' 字符。此标志适用于所有 URL，包括非跳转 URL。
Manager.URL_CANONFLAGS：定义为与 Manager.URL_CANONFLAGS 相同。
Manager.URL_CANONFLAGS：根据万维网联合会 (W3C) 规范，将 URL 与客户端定义的可插入协议结合起来。此标志不适用于标准协议，如 FTP、HTTP 和 Gopher。如果设置了此标志，就不必设置 Manager.URL_CANONFLAGS。
Manager.URL_CANONFLAGS：对 URL 包含的任何转义序列进行转回，但有两个转义序列例外。未对“?”和“#”的转义序列进行转回操作。如果还设置了 URL_ESCAPE 标志之一，那么对两个 URL 依次执行的操作是：转回、合并和转义。

String

规范化的 URL。