Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.IE
Сборка:
IEHost.dll

Преобразует строку 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

Строка, заканчивающаяся на NULL, максимальной длины (INTERNET_MAX_URL_LENGTH), содержащая строку URL-адреса. Если строка не ссылается на файл, она должна содержать допустимую схему, например http://.

flags
Manager.URL_CANONFLAGS

Флаги, определяющие, как URL-адрес будет преобразовываться в каноническую форму. Следующие флаги можно сочетать:

  • Manager.URL_CANONFLAGS: обрабатывают "/./" и "/../" в строке URL-адреса как символы-литералы, а не сокращение для навигации.

  • Manager.URL_CANONFLAGS: преобразуют все вхождения "%" в escape-последовательность.

  • Manager.URL_CANONFLAGS: заменяют только пробелы на escape-последовательности. Этот флаг имеет приоритет над Manager.URL_CANONFLAGS, но не применяется к непрозрачным URL-адресам.

  • Manager.URL_CANONFLAGS: заменяют небезопасные символы на escape-последовательности. Небезопасные символы — это символы, которые могут быть изменены во время передачи через Интернет. Они включают символы <, >", ", #, {, }, |, \, ^, [, ] и ' . Этот флаг применяется ко всем URL-адресам, включая непрозрачные URL-адреса.

  • Manager.URL_CANONFLAGS: определяются так же, как Manager.URL_CANONFLAGS.

  • Manager.URL_CANONFLAGS: объединяют URL-адреса с определяемыми клиентом подключаемыми протоколами в соответствии со спецификацией консорциума W3C. Этот флаг не применяется к стандартным протоколам, таким как FTP, HTTP и Gopher. Если этот флаг установлен, не нужно также устанавливать Manager.URL_CANONFLAGS.

  • Manager.URL_CANONFLAGS: отменяют все escape-последовательности, которые содержат URL-адреса, с двумя исключениями. Escape-последовательности для "?" и "#" не отменяются. Если также установлен один из флагов URL_ESCAPE, сначала у двух URL-адресов отменяется escape-последовательность, потом они объединяются, а затем escape-последовательность снова применяется.

Возвращаемое значение

String

Канонический URL-адрес.

Применяется к