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

Статья
03/30/2023

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

<Конфигурации>
  <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>

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