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

  • Статья

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

<Конфигурации>
  <system.net>
    <defaultProxy>
      <Прокси>

Синтаксис

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

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

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

Атрибуты

Attribute Описание
autoDetect Указывает, обнаруживается ли прокси-сервер автоматически. Значение по умолчанию — Unspecified.
bypassonlocal Указывает, используется ли прокси-сервер для локальных ресурсов. Локальные ресурсы включают локальный сервер (http://localhost, http://loopbackили http://127.0.0.1) и URI без точки (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).

Пример

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

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

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