<proxyelement> (netwerkinstellingen)

Artikel
05/09/2023

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

Delen via