<defaultProxy-element> (netwerkinstellingen)

Artikel
08/15/2023

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

<configuratie><system.net<>defaultProxy>

Notitie

Als u migreert naar .NET 6+, configureert u de proxyserver met behulp van de HttpClient.DefaultProxy eigenschap.

Syntaxis

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

Kenmerken en elementen

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

Kenmerken

Element	Beschrijving
`enabled`	Hiermee geeft u op of een webproxy wordt gebruikt. De standaardwaarde is `True`.
`useDefaultCredentials`	Hiermee geeft u op of de standaardreferenties voor deze host worden gebruikt voor toegang tot de webproxy. De standaardwaarde is `False`.

Onderliggende elementen

Element	Beschrijving
bypasslist	Biedt een set reguliere expressies die adressen beschrijven die de proxy niet gebruiken.
Module	Voegt een nieuwe proxymodule toe aan de toepassing.
Proxy	Hiermee definieert u een proxyserver.

Bovenliggende elementen

Element	Beschrijving
system.net	Bevat instellingen die aangeven hoe .NET Framework verbinding maakt met het netwerk.

Opmerkingen

Als het defaultProxy element leeg is, worden de systeemproxy-instellingen gebruikt.

Er wordt een uitzondering gegenereerd als het moduleelement een niet-openbaar type opgeeft, het type is niet afgeleid van de IWebProxy klasse, een uitzondering van de parameterloze constructor van dit object opgetreden of een uitzondering opgetreden tijdens het ophalen van de door het systeem opgegeven standaardproxy. De InnerException eigenschap op de uitzondering moet meer informatie hebben over de hoofdoorzaak van de fout.

Configuratiebestanden

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

voorbeeld

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

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>