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

Článek
03/30/2023

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://loopback`nebo `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>

Sdílet prostřednictvím