HttpListenerElement Класс

Определение

public ref class HttpListenerElement sealed : System::Configuration::ConfigurationElement

public sealed class HttpListenerElement : System.Configuration.ConfigurationElement

type HttpListenerElement = class
    inherit ConfigurationElement

Public NotInheritable Class HttpListenerElement
Inherits ConfigurationElement

Наследование

Object

ConfigurationElement

HttpListenerElement

Комментарии

Этот класс соответствует элементу конфигурации <httpListener> Element (Network Settings). Этот класс предоставляет программный доступ к сведениям, которые могут храниться в файлах конфигурации.

Свойство UnescapeRequestUrl указывает, использует ли HttpListener необработанный неэкранированный URI вместо преобразованного URI, в котором преобразуются значения в процентах и выполняются другие шаги нормализации.

HttpListener Когда экземпляр получает запрос через http.sys службу, он создает экземпляр строки URI, предоставленной http.sys, и предоставляет его в качестве HttpListenerRequest.Url свойства .

Служба http.sys предоставляет две строки URI запроса:

• Необработанный URI

• Преобразованный URI

Необработанный универсальный System.Uri код ресурса (URI) — это указанный в строке запроса HTTP-запроса:

GET /path/

Host: www.contoso.com

Необработанный универсальный код ресурса (URI), предоставленный http.sys для упомянутого выше запроса, — "/path/". Представляет строку, следующую за HTTP-командой, когда она была отправлена по сети.

Служба http.sys создает преобразованный URI на основе информации, предоставленной в запросе, с помощью URI, предоставленного в строке HTTP-запроса, и заголовка Узла для определения исходного сервера, на который должен быть переадресован запрос. Для этого сравнивается информация из запроса с набором зарегистрированных префиксов URI. В документации по пакету SDK ДЛЯ HTTP-сервера этот преобразованный URI называется структурой HTTP_COOKED_URL .

Чтобы иметь возможность сравнивать запрос с зарегистрированными префиксами URI, необходимо выполнить некоторую нормализацию запроса. Для примера выше преобразованный универсальный код ресурса (URI) будет следующим:

http://www.contoso.com/path/

Служба http.sys объединяет Uri.Host значение свойства и строку в строке запроса для создания преобразованного URI. Кроме того, http.sys класс System.Uri также выполняет следующие действия:

• Отменяет экранирование всех значений в процентах.

• Преобразует символы в процентах, отличные от ASCII, в представление символов UTF-16. Обратите внимание, что поддерживаются символы UTF-8 и ANSI/DBCS, а также символы Юникода (кодировка Юникода в формате %uXXXX).

• Выполняет другие шаги нормализации, например сжатие пути.

Так как запрос не содержит сведений о кодировке, используемой для значений в процентах, определить правильную кодировку только путем анализа значений в процентах может быть невозможно.

Поэтому http.sys предоставляет два раздела реестра для изменения процесса:

При HttpListener получении запроса он использует преобразованный универсальный код ресурса (URI) из в http.sys качестве входных данных в Url свойство .

Кроме символов и чисел в URI необходимо использовать вспомогательные символы. Примером является следующий универсальный код ресурса (URI), который используется для получения сведений о клиенте по номеру клиента "1/3812":

http://www.contoso.com/Customer('1%2F3812')/

Обратите внимание на косую черту, закодированную в процентах, в URI (%2F). Это необходимо, так как в этом случае символ косой черты представляет данные, а не разделитель пути.

Передача строки в конструктор URI приведет к следующему URI:

http://www.contoso.com/Customer('1/3812')/

Разделение пути на его сегменты приведет к созданию следующих элементов:

Customer('1

3812')

Это не является намерением отправителя запроса.

Если свойству UnescapeRequestUrl присвоено значение false, то при HttpListener получении запроса он использует необработанный универсальный код ресурса (URI) вместо преобразованного URI из в http.sys качестве входных данных в Url свойство .

Конструкторы

Свойства

Методы

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

См. также раздел

• HttpListener
• Url
• Схема параметров сети
• <Элемент httpListener> (параметры сети)