通过

<proxy> 元素（网络设置）

  • 项目

更新：2007 年 11 月

定义代理服务器。

<configuration> 元素
  <system.Net> 元素（网络设置）
    <defaultProxy> 元素（网络设置）
      <proxy> 元素（网络设置）

<proxy 
  autoDetect="true|false|unspecified"  
  bypassonlocal="true|false|unspecified" 
  proxyaddress="uriString"
  scriptLocation="uriString" 
  usesystemdefault="true|false|unspecified " 
/>

属性和元素

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

属性

属性

说明

autoDetect

指定是否自动检测代理。默认值为 unspecified。

bypassonlocal

指定是否对本地资源跳过代理。本地资源包括本地服务器（https://localhost、https://loopback 或 http://127.0.0.1）和不带句点的 URI (http://webserver)。默认值为 unspecified。

proxyaddress

指定要使用的代理 URI。

scriptLocation

指定配置脚本的位置。

usesystemdefault

指定是否使用 Internet Explorer 代理设置。如果设置为 true，则后面的属性将重写 Internet Explorer 代理设置。默认值为 unspecified。

子元素

无。

父元素

元素

说明

defaultProxy

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

备注

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

proxyaddress 属性的值应当是格式良好的统一资源标识符 (URI)。

scriptLocation 属性引用代理自动检测配置脚本。当在 Internet Explorer 中选中了“使用自动配置脚本”选项时，WebProxy 类将试图定位配置脚本（其名称通常为 Wpad.dat）。

对于要迁移到 2.0 版的 .NET Framework 1.1 版应用程序，请使用 usesystemdefault 属性。

配置文件

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

示例

下面的代码示例使用 Internet Explorer 代理的默认设置，指定代理地址并对本地访问跳过代理。

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

请参见

参考

网络设置架构

System.Net.WebProxy