<defaultProxy> 元素(网络设置)

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

<配置><system.net><defaultProxy>

注释

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

Syntax

<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如果该元素为空,则使用系统代理设置。

如果 模块 元素指定非公共类型、类型不派生自 IWebProxy 类、发生此对象的无参数构造函数的异常或检索系统指定的默认代理时发生异常,则会引发异常。 InnerException异常的属性应提供有关错误的根本原因的详细信息。

配置文件

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

Example

以下示例使用系统代理中的默认值,指定代理地址,并绕过代理进行本地访问和 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>

另请参阅