Sdílet prostřednictvím

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

Definuje proxy server.

<konfigurace>
   <system.net>
     <defaultProxy>
       <plná moc>

Syntaxe

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

Atributy a prvky

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

Attributes

Atribut Description
autoDetect Určuje, jestli se proxy server automaticky zjistí. Výchozí hodnota je Unspecified.
bypassonlocal Určuje, jestli se proxy server vynechá pro místní prostředky. Místní prostředky zahrnují 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 atribut s tímto atributem bypassonlocal .
usesystemdefault Určuje, jestli se má použít nastavení proxy serveru systému. Pokud je nastavená hodnota True, následující atributy přepíší nastavení proxy systému. Výchozí hodnota je Unspecified.

Podřízené prvky

Žádné.

Nadřazené prvky

Element Description
defaultProxy Nakonfiguruje proxy server HTTP (Hypertext Transfer Protocol).

Textová hodnota

Poznámky

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

Hodnota atributu proxyaddress by měla být správně formátovaný identifikátor 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 pojmenovaný Wpad.dat), když 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).

Example

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

  • Last updated on