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:用转义序列替换不安全字符。 不安全字符是在 Internet 传输过程中可能会更改的字符。 它们包括 <、 >、“、#、{、}、|、\、^、[、]和 ' 字符。 此标志适用于所有 URL,包括非跳转 URL。
Manager.URL_CANONFLAGS:根据万维网联合会 (W3C) 规范,将 URL 与客户端定义的可插入协议结合起来。 此标志不适用于标准协议,如 FTP、HTTP 和 Gopher。 如果设置了此标志,就不必设置 Manager.URL_CANONFLAGS。
Manager.URL_CANONFLAGS:对 URL 包含的任何转义序列进行转回,但有两个转义序列例外。 未对“?”和“#”的转义序列进行转回操作。 如果还设置了 URL_ESCAPE 标志之一,那么对两个 URL 依次执行的操作是:转回、合并和转义。
返回
规范化的 URL。