<defaultProxy> Element (Network Settings)

Configures the Hypertext Transfer Protocol (HTTP) proxy server.

<defaultProxy
  enabled="true|false"
  useDefaultCredentials="true|false"
    <bypasslist> … </bypasslist>
    <proxy> … </proxy>
    <module> … </module>
/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Element Description

enabled

Specifies whether a web proxy is used. The default value is true.

useDefaultCredentials

Specifies whether the default credentials for this host are used to access the web proxy. The default value is false.

Child Elements

Element Description

bypasslist

Provides a set of regular expressions that describe addresses that do not use the proxy.

module

Adds a new proxy module to the application.

proxy

Defines a proxy server.

Parent Elements

Element Description

system.net

Contains settings that specify how the .NET Framework connects to the network.

Remarks

If the defaultProxy element is empty, the proxy settings from Internet Explorer will be used. This behavior is different from version 1.1 of the .NET Framework.

Configuration Files

This element can be used in the application configuration file or the machine configuration file (Machine.config).

Example

The following code example uses the defaults from the Internet Explorer proxy, specifies the proxy address, and bypasses the proxy for local access and contoso.com.

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

See Also

Reference

Network Settings Schema
WebProxy