<proxyelem> (hálózati beállítások)

  • Cikk

Proxykiszolgálót definiál.

<Konfigurációs>
  <system.net>
    <defaultProxy>
      <proxy>

Syntax

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

Attribútumok és elemek

Az alábbi szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attribútumok

Attribútum Leírás
autoDetect Meghatározza, hogy a rendszer automatikusan észlelje-e a proxyt. Az alapértelmezett érték Unspecified.
bypassonlocal Meghatározza, hogy a proxyt megkerüli-e a rendszer a helyi erőforrások esetében. A helyi erőforrások közé tartozik a helyi kiszolgáló (http://localhost, vagy http://loopbackhttp://127.0.0.1) és egy URI pont nélkül (http://webserver). Az alapértelmezett érték Unspecified.
proxyaddress Megadja a használni kívánt proxy URI-t.
scriptLocation Megadja a konfigurációs szkript helyét. Ne használja az attribútumot ezzel az bypassonlocal attribútummal.
usesystemdefault Megadja, hogy a rendszerproxy-beállításokat használja-e. Ha a értékre van állítva, a Truetovábbi attribútumok felülbírálják a rendszerproxy-beállításokat. Az alapértelmezett érték Unspecified.

Gyermekelemek

Nincsenek.

Szülőelemek

Elem Leírás
defaultProxy Konfigurálja a HTTP-proxykiszolgálót.

Szöveges érték

Megjegyzések

Az proxy elem proxykiszolgálót határoz meg egy alkalmazáshoz. Ha ez az elem hiányzik a konfigurációs fájlból, akkor .NET-keretrendszer a rendszerproxy-beállításokat fogja használni.

Az attribútum értékének proxyaddress megfelelően formázott egységes erőforrás-mutatónak (URI) kell lennie.

Az scriptLocation attribútum a proxykonfigurációs szkriptek automatikus észlelésére utal. Az WebProxy osztály megkísérli megkeresni a konfigurációs szkriptet (általában Wpad.dat néven), ha az Automatikus konfigurációs szkript használata beállítás van kiválasztva a kapcsolathoz az internettulajdonságokban. Ha bypassonlocal bármely értékre van állítva, scriptLocation a rendszer figyelmen kívül hagyja.

A rendszer kivételt jelez, ha az proxyaddress attribútum érvénytelen alapértelmezett proxyt ad meg. A InnerException kivétel tulajdonságának további információval kell rendelkeznie a hiba kiváltó okáról.

Konfigurációs fájlok

Ez az elem használható az alkalmazáskonfigurációs fájlban vagy a gép konfigurációs fájljában (Machine.config).

Példa

Az alábbi példa a rendszerproxy alapértelmezett értékét használja, megadja a proxy címét, és megkerüli a proxyt a helyi hozzáféréshez.

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

Lásd még