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

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

<конфигурация>
   <system.net>
     <defaultProxy>
       <доверенность>

Синтаксис

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

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

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

Attributes

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

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

Нет.

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

Элемент	Описание
defaultProxy	Настраивает прокси-сервер протокола передачи гипертекста (HTTP).

Текстовое значение

Замечания

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

Значение атрибута proxyaddress должно быть хорошо сформированным универсальным индикатором ресурсов (URI).

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

Исключение возникает, если proxyaddress атрибут указывает недопустимый прокси-сервер по умолчанию. Свойство InnerException исключения должно иметь дополнительные сведения о первопричине ошибки.

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

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

Example

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

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

См. также

• System.Net.WebProxy
• Схема параметров сети