<bypasslist> Element (Network Settings)

Article
12/08/2006

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

<bypasslist> 
</bypasslist>

Attributes and Elements

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

Attributes

None.

Child Elements

Element	Description
add	Adds an IP address or DNS name to the proxy bypass list.
clear	Clears the bypass list.
remove	Removes an IP address or DNS name from the proxy bypass list.

Parent Elements

Element	Description
defaultProxy	Configures the Hypertext Transfer Protocol (HTTP) proxy server.

Remarks

The bypass list contains regular expressions that describe URIs that WebRequest instances access directly instead of through the proxy server.

You should use caution when specifying a regular expression for this element. The regular expression "[a-z]+\.contoso\.com" matches any host in the contoso.com domain, but it also matches any host in the contoso.com.cpandl.com domain. To match only a host in the contoso.com domain, use an anchor ("$"): "[a-z]+\.contoso\.com$".

For more information about regular expressions, see ..NET Framework Regular Expressions.

Configuration Files

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

Example

The following code example adds two addresses to the bypass list. The first bypasses the proxy for all servers in the contoso.com domain; the second bypasses the proxy for all servers whose IP addresses begin with 192.168.

<configuration>
  <system.net>
    <defaultProxy>
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
        <add address="192\.168\.\d{1,3}\.\d{1,3}" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>

Partager via