Delen via

<proxyelement> (netwerkinstellingen)

Definieert een proxyserver.

<configuratie>
   <system.net>
     <defaultProxy>
       <Proxy>

Syntax

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk Beschrijving
autoDetect Hiermee geeft u op of de proxy automatisch wordt gedetecteerd. De standaardwaarde is Unspecified.
bypassonlocal Hiermee geeft u op of de proxy wordt overgeslagen voor lokale resources. Lokale resources omvatten de lokale server (http://localhost, http://loopbackof http://127.0.0.1) en een URI zonder punt (http://webserver). De standaardwaarde is Unspecified.
proxyaddress Hiermee geeft u de proxy-URI te gebruiken.
scriptLocation Hiermee geeft u de locatie van het configuratiescript. Gebruik het bypassonlocal kenmerk niet met dit kenmerk.
usesystemdefault Hiermee geeft u op of de systeemproxy-instellingen moeten worden gebruikt. Als dit is ingesteld op True, overschrijven volgende kenmerken de systeemproxy-instellingen. De standaardwaarde is Unspecified.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element Beschrijving
defaultProxy Hiermee configureert u de HTTP-proxyserver (Hypertext Transfer Protocol).

Tekstwaarde

Opmerkingen

Het proxy element definieert een proxyserver voor een toepassing. Als dit element ontbreekt in het configuratiebestand, gebruikt .NET Framework de systeemproxy-instellingen.

De waarde voor het proxyaddress kenmerk moet een goed gevormde URI (Uniform Resource Indicator) zijn.

Het scriptLocation kenmerk verwijst naar de automatische detectie van proxyconfiguratiescripts. De WebProxy klasse probeert een configuratiescript (meestal met de naam Wpad.dat) te vinden wanneer de optie Automatisch configuratiescript gebruiken is geselecteerd voor de verbinding in interneteigenschappen. Als bypassonlocal is ingesteld op een waarde, scriptLocation wordt genegeerd.

Er wordt een uitzondering gegenereerd als het proxyaddress kenmerk een ongeldige standaardproxy opgeeft. De InnerException eigenschap voor de uitzondering moet meer informatie bevatten over de hoofdoorzaak van de fout.

Configuratiebestanden

Dit element kan worden gebruikt in het configuratiebestand van de toepassing of in het configuratiebestand van de machine (Machine.config).

Voorbeeld

In het volgende voorbeeld worden de standaardwaarden van de systeemproxy gebruikt, wordt het proxyadres opgegeven en wordt de proxy overgeslagen voor lokale toegang.

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

Zie ook