<defaultProxy> 元素(网络设置)

配置超文本传输协议 (HTTP) 代理服务器。

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

特性和元素

以下几节描述了属性、子元素和父元素。

特性

元素

说明

enabled

指定是否使用 Web 代理。 默认值为 true。

useDefaultCredentials

指定是否使用此主机的默认凭据访问 Web 代理。 默认值为 false。

子元素

元素

说明

<bypasslist>

提供一组正则表达式来描述不使用代理的地址。

<module>-模块

向应用程序添加新的代理模块。

<proxy>

定义代理服务器。

父元素

元素

说明

<系统。 net>

包含指定 .NET Framework 与网络的连接方式的设置。

备注

如果 defaultProxy 元素为空,将使用 Internet Explorer 中的代理设置。 此行为不同于 1.1 版的 .NET Framework。

如果<模块>元素指定非公共类型,类型不从 IWebProxy 类派生,此对象的默认构造函数中出现异常或检索系统指定的默认代理时出现异常,则会引发异常。 该异常上的 InnerException 属性应该有关于错误根本原因的详细信息。

配置文件

此元素可以用在应用程序配置文件或计算机配置文件 (Machine.config) 中。

示例

下面的代码示例使用 Internet Explorer 代理中的默认设置,指定代理地址,并对本地访问和 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>

请参见

参考

网络设置架构

System.Net.WebProxy