<element proxy> (nastavení sítě)

  • Článek

Definuje proxy server.

<Konfigurace>
  <system.net>
    <defaultProxy>
      <proxy>

Syntax

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

Atributy a elementy

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

Atributy

Atribut Popis
autoDetect Určuje, jestli se automaticky zjistí proxy server. Výchozí hodnota je Unspecified.
bypassonlocal Určuje, jestli se proxy server vynechá pro místní prostředky. Mezi místní prostředky patří místní server (http://localhost, http://loopbacknebo http://127.0.0.1) a identifikátor URI bez tečky (http://webserver). Výchozí hodnota je Unspecified.
proxyaddress Určuje identifikátor URI proxy serveru, který se má použít.
scriptLocation Určuje umístění konfiguračního skriptu. Nepoužívejte bypassonlocal atribut s tímto atributem.
usesystemdefault Určuje, zda se má použít nastavení systémového proxy serveru. Pokud je nastavená na True, následující atributy přepíšou nastavení proxy serveru systému. Výchozí hodnota je Unspecified.

Podřízené elementy

Žádné

Nadřazené elementy

Prvek Popis
defaultProxy Nakonfiguruje proxy server HTTP (Hypertext Transfer Protocol).

Textová hodnota

Poznámky

Element proxy definuje proxy server pro aplikaci. Pokud tento prvek chybí v konfiguračním souboru, pak rozhraní .NET Framework použije nastavení systémového proxy serveru.

Hodnota atributu proxyaddress by měla být ve správném formátu identifikátoru URI (Uniform Resource Indicator).

Atribut scriptLocation odkazuje na automatickou detekci konfiguračních skriptů proxy serveru. Třída WebProxy se pokusí vyhledat konfigurační skript (obvykle s názvem Wpad.dat), pokud je pro připojení ve vlastnostech Internetu vybraná možnost Použít automatický konfigurační skript . Pokud bypassonlocal je nastavená na libovolnou hodnotu, scriptLocation bude ignorována.

Pokud atribut určuje neplatný výchozí proxy server, vyvolá proxyaddress se výjimka. 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 serveru a obchází proxy server pro místní přístup.

<configuration>  
  <system.net>  
    <defaultProxy>  
      <proxy  
        usesystemdefault="True"  
        proxyaddress="http://192.168.1.10:3128"  
        bypassonlocal="True"  
      />  
    </defaultProxy>  
  </system.net>  
</configuration>

Viz také