<defaultProxy> – element (nastavení sítě)

Článek
08/15/2023

Nakonfiguruje proxy server HTTP (Hypertext Transfer Protocol).

<konfigurace><system.net<>defaultProxy>

Poznámka:

Pokud migrujete na .NET 6 nebo novější, nakonfigurujte proxy server pomocí HttpClient.DefaultProxy vlastnosti.

Syntaxe

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Element	Description
`enabled`	Určuje, jestli se používá webový proxy server. Výchozí hodnota je `True`.
`useDefaultCredentials`	Určuje, jestli se pro přístup k webovému proxy serveru používají výchozí přihlašovací údaje pro tohoto hostitele. Výchozí hodnota je `False`.

Podřízené prvky

Element	Description
Bypasslist	Poskytuje sadu regulárních výrazů, které popisují adresy, které nepoužívají proxy server.
module	Přidá do aplikace nový modul proxy.
Proxy	Definuje proxy server.

Nadřazené prvky

Element	Description
system.net	Obsahuje nastavení, která určují, jak se rozhraní .NET Framework připojuje k síti.

Poznámky

defaultProxy Pokud je prvek prázdný, použijí se nastavení proxy systému.

Výjimka je vyvolána, pokud prvek modulu určuje neveřejný typ, typ neodvozuje z IWebProxy třídy, výjimku z konstruktoru bez parametrů tohoto objektu došlo nebo došlo k výjimce při načítání výchozího proxy serveru určeného systémem. Vlastnost InnerException výjimky by měla obsahovat další informace o původní příčině chyby.

Konfigurační soubory

Tento prvek lze použít v konfiguračním souboru aplikace nebo v konfiguračním souboru počítače (Machine.config).

Příklad

Následující příklad používá výchozí hodnoty ze systémového proxy serveru, určuje adresu proxy a obchází proxy server pro místní přístup a 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>

Sdílet prostřednictvím