Click to Rate and Give Feedback
Collapse All/Expand All Collapse All
This page is specific to
Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:
<defaultProxy> Element (Network Settings)

Configures the Hypertext Transfer Protocol (HTTP) proxy server.

<configuration> Element
  <system.Net> Element (Network Settings)
    <defaultProxy> Element (Network Settings)
<defaultProxy
  enabled="true|false"
  useDefaultCredentials="true|false"
  <bypasslist> … </bypasslist>
  <proxy> … </proxy>
  <module> … </module>
/>

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.

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.

An exception is thrown if the module element specifies a non-public type, the type is not deriving from the IWebProxy class, an exception from the default constructor of this object occurred, or an exception occurred while retrieving the system-specified default proxy. The InnerException property on the exception should have more information about the root cause of the error.

Configuration Files

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

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>
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Corrected Sample      Y2KPRABU ... Noelle Mallory - MSFT   |   Edit   |   Show History

The code sample at the end is incorrect .here is the correct version. it is usesystemdefault without the 's'.

<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>

Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker