<defaultProxy> , element (ustawienia sieciowe)

  • Artykuł

Konfiguruje serwer proxy protokołu HTTP (Hypertext Transfer Protocol).

<konfiguracja><system.net<>defaultProxy>

Uwaga

Jeśli przeprowadzasz migrację do platformy .NET 6 lub nowszej, skonfiguruj serwer proxy przy użyciu HttpClient.DefaultProxy właściwości .

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Element Opis
enabled Określa, czy jest używany internetowy serwer proxy. Wartość domyślna to True.
useDefaultCredentials Określa, czy domyślne poświadczenia dla tego hosta są używane do uzyskiwania dostępu do internetowego serwera proxy. Wartość domyślna to False.

Elementy podrzędne

Element Opis
Bypasslist Zawiera zestaw wyrażeń regularnych opisujących adresy, które nie używają serwera proxy.
module Dodaje nowy moduł proxy do aplikacji.
Serwera proxy Definiuje serwer proxy.

Elementy nadrzędne

Element Opis
system.net Zawiera ustawienia określające sposób łączenia programu .NET Framework z siecią.

Uwagi

defaultProxy Jeśli element jest pusty, używane są ustawienia serwera proxy systemu.

Wyjątek jest zgłaszany, jeśli element modułu określa typ inny niż publiczny, typ nie pochodzi z IWebProxy klasy, wyjątek od konstruktora bez parametrów tego obiektu wystąpił lub wystąpił wyjątek podczas pobierania domyślnego serwera proxy określonego przez system. Właściwość InnerException wyjątku powinna zawierać więcej informacji na temat głównej przyczyny błędu.

Pliki konfiguracji

Tego elementu można użyć w pliku konfiguracji aplikacji lub pliku konfiguracji maszyny (Machine.config).

Przykład

Poniższy przykład używa wartości domyślnych z serwera proxy systemu, określa adres serwera proxy i pomija serwer proxy dla dostępu lokalnego i 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>

Zobacz też