<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>