<proxy>元素（网络设置）

  • 项目

定义代理服务器。

configuration
  <system.net>
    <defaultProxy>
      <proxy>

语法

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

特性和元素

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

特性

Attribute 说明
autoDetect 指定是否自动检测代理。 默认值为 Unspecified。
bypassonlocal 指定对于本地资源是否跳过代理。 本地资源包括本地服务器（http://localhost、http://loopback 或 http://127.0.0.1），以及不带句点的 (http://webserver) 的 URI。 默认值为 Unspecified。
proxyaddress 指定使用的代理 URI。
scriptLocation 指定配置脚本的位置。 不要将 bypassonlocal 特性与此属性一起使用。
usesystemdefault 指定是否使用系统代理设置。 如果设置为 True，则后续特性将替代系统代理设置。 默认值为 Unspecified。

子元素

无。

父元素

元素 说明
defaultProxy 配置超文本传输协议 (HTTP) 代理服务器。

文本值

备注

元素 proxy 用于定义应用程序的代理服务器。 如果配置文件中缺少此元素，则 .NET Framework 将使用系统代理设置。

proxyaddress 属性的值应为格式标准的统一资源标识符 (URI)。

属性 scriptLocation 指自动检测代理配置脚本。 若在 Internet 属性中对连接选择“使用自动配置脚本”选项，WebProxy 类将尝试定位配置脚本（通常名为 Wpad.dat）。 如果将 bypassonlocal 设为任何值，则将忽略 scriptLocation。

如果 proxyaddress 属性指定了无效的默认代理，则会引发异常。 异常的 InnerException 属性应具有错误根本原因的详细信息。

配置文件

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

示例

下面的示例使用来自系统代理的默认值，指定代理地址，并且在进行本地访问时不使用代理。

<configuration>  
  <system.net>  
    <defaultProxy>  
      <proxy  
        usesystemdefault="True"  
        proxyaddress="http://192.168.1.10:3128"  
        bypassonlocal="True"  
      />  
    </defaultProxy>  
  </system.net>  
</configuration>

另请参阅