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

Статья
08/15/2023

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

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

Заметка

Если вы выполняете миграцию на .NET 6+, настройте прокси-сервер с помощью HttpClient.DefaultProxy свойства.

Синтаксис

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

Элементы и атрибуты

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

Атрибуты

Element	Описание
`enabled`	Указывает, используется ли веб-прокси. Значение по умолчанию — `True`.
`useDefaultCredentials`	Указывает, используются ли учетные данные по умолчанию для этого узла для доступа к веб-прокси. Значение по умолчанию — `False`.

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

Element	Описание
обходный список	Предоставляет набор регулярных выражений, описывающих адреса, которые не используют прокси-сервер.
module	Добавляет в приложение новый модуль прокси-сервера.
прокси-сервер	Определяет прокси-сервер.

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

Element	Описание
system.net	Содержит параметры, указывающие, как платформа .NET Framework подключается к сети.

Замечания

defaultProxy Если элемент пуст, используются параметры системного прокси-сервера.

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

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

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

пример

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

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>