Элемент <proxy> (параметры сети)

Статья
11/05/2008

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

Определяет прокси-сервер.

Элемент <configuration>
  Элемент <system.Net> (параметры сети)
    Элемент <defaultProxy> (параметры сети)
      Элемент <proxy> (параметры сети)

<proxy 
  autoDetect="true|false|unspecified"  
  bypassonlocal="true|false|unspecified" 
  proxyaddress="uriString"
  scriptLocation="uriString" 
  usesystemdefault="true|false|unspecified " 
/>

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

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

Атрибуты

Атрибут	Описание
autoDetect	Указывает, определяется ли прокси-сервер автоматически. Значение по умолчанию – unspecified.
bypassonlocal	Указывает, пропускает ли прокси-сервер адреса локальных ресурсов. Адрес локального ресурса – это локальный адрес сервера (https://localhost, https://loopback или http://127.0.0.1) и URI без точки (http://webserver). ЗЗначение по умолчанию – unspecified.
proxyaddress	Указывает URI, используемый прокси-сервером.
scriptLocation	Указывает расположение сценария конфигурации.
usesystemdefault	Указывает, используются ли обозревателем Internet Explorer настройки прокси-сервера. Если используется значение true, следующие атрибуты переопределят настройки прокси-сервера в обозревателе Internet Explorer. Значение по умолчанию – unspecified.

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

Нет.

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

Элемент	Описание
defaultProxy	Настраивает работу протокола HTTP прокси-сервера.

Заметки

Элемент proxy определяет прокси-сервер для приложения. Если этот элемент отсутствует в файле конфигурации, то платформа .NET Framework использует настройки прокси-сервера из обозревателя Internet Explorer.

Значение атрибута proxyaddress должно иметь правильный формат URI.

Атрибут scriptLocation задает автоматическое определение размещения сценария конфигурации прокси-сервера. Если в обозревателе Internet Explorer установлена опция Использовать сценарий автоматической настройки, класс WebProxy попытается обнаружить сценарий конфигурации (обычно с названием Wpad.dat).

Используйте атрибут usesystemdefault для приложений .NET Framework версии 1.1 при переходе на версию 2.0.

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

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

Пример

В следующем примере кода показано использование настроек прокси-сервера из Internet Explorer, задание адреса прокси-сервера и отмена использования прокси-сервера для локальных адресов и домена contoso.com.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="true"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="true"
      />
    </defaultProxy>
  </system.net>
</configuration>

См. также

Ссылки

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

System.Net.WebProxy

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