Элемент <add> для элемента webRequestModules (параметры сети)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Добавляет в приложение пользовательский модуль веб-запросов.

Элемент <configuration>
  Элемент <system.Net> (параметры сети)
    Элемент <webRequestModules> (параметры сети)
      Элемент <add> для элемента webRequestModules (параметры сети)

<add 
  prefix = "URI prefix" 
  type = "module name, Version, Culture, PublicKeyToken" 
/>

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
prefix	Префикс URI для запросов, обрабатываемых данным модулем веб-запросов.
type	Имя сборки и класса модуля, реализующего данный модуль веб-запросов.

Дочерние элементы

Нет.

Родительские элементы

Элемент	Описание
webRequestModules	Задает модули, используемые для запроса данных от сетевых узлов.

Заметки

Атрибут prefix определяет префикс URI, используемый заданным модулем веб-запросов. Такие модули веб-запросов обычно регистрируются для обработки конкретных протоколов, например HTTP или FTP, но они также могут быть зарегистрированы и для обработки запросов к заданному серверу или пути на сервере.

Модуль веб-запроса создается, когда URI, соответствующий префиксу, передается методу WebRequest.Create.

Значением атрибута prefix должны быть первые символы действительного URI, например "http" или "https://www.contoso.com".

Значением атрибута type должно быть допустимое имя библиотеки DLL или соответствующее имя класса, отделенное запятой.

Файлы конфигурации

Этот элемент можно использовать в файле конфигурации приложения или в файле конфигурации компьютера (Machine.config).

Пример

В следующем примере кода выполняется регистрация пользовательского модуля веб-запросов для HTTP. Необходимо заменить значения для параметров Version и PublicKeyToken правильными значениями для указанного модуля.

<configuration>
  <system.net>
    <webRequestModules>
      <add prefix="http"
           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,
           Culture=neutral, PublicKeyToken=b77a5c561934e089"
      />
    </webRequestModules>
  </system.net>
</configuration>

См. также

Ссылки

Схема параметров сети

WebRequest

Поделиться через