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

  • Článek

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>

Viz také