<defaultProxy> 元素（网络设置）

  • 项目

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

<configuration><system.net><defaultProxy>

说明

如果要迁移到 .NET 6+，请使用 HttpClient.DefaultProxy 属性配置代理服务器。

语法

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

特性和元素

下列各节描述了特性、子元素和父元素。

特性

元素 说明
enabled 指定是否使用 Web 代理。 默认值为 True。
useDefaultCredentials 指定是否使用此主机的默认凭据来访问 Web 代理。 默认值为 False。

子元素

元素 说明
bypasslist 提供一组描述不使用代理的地址的正则表达式。
module 向应用程序添加新的代理模块。
proxy 定义代理服务器。

父元素

元素 说明
system.net 包含指定 .NET Framework 如何连接到网络的设置。

备注

如果 defaultProxy 元素为空，则会使用系统代理设置。

如果 module 元素指定非公共类型，该类型不派生自 IWebProxy 类，此对象的无参数构造函数出现异常，或者检索系统指定的默认代理时发生了异常，则会引发异常。 异常的 InnerException 属性应具有错误根本原因的详细信息。

配置文件

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

示例

下面的示例使用来自系统代理的默认值，指定代理地址，并且在进行本地访问和访问 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>

另请参阅