WebProxy 类

定义

命名空间:

System.Net

程序集:

netstandard.dll, System.Net.WebProxy.dll

Source:

WebProxy.cs

包含类的 HttpClient HTTP 代理设置。

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

继承

Object

WebProxy

实现

IWebProxy ISerializable

示例

下面的代码示例使用实例设置 HttpClient 实例 WebProxy 。 该 HttpClient 实例使用代理连接到外部 Internet 资源。 （有关演示如何使用 WPAD 功能的示例，请参阅该 IWebProxyScript 类的文档。

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

注解

该 WebProxy 类包含实例用来确定 Web 代理是否用于发送请求的代理设置 HttpClient 。 可以在计算机和应用程序配置文件中指定全局 Web 代理设置，应用程序可以使用类的 WebProxy 实例来自定义 Web 代理使用。 该 WebProxy 类是接口的基本 IWebProxy 实现。

若要获取 Web 代理类的实例，可以使用以下任一方法：

• 构造 WebProxy 函数。
• GetDefaultProxy 方法。
• Select 方法。

这些方法各提供一个可以进一 WebProxy 步自定义的实例;它们之间的差异在于实例在返回到应用程序之前如何初始化实例。 构造WebProxy函数返回属性设置为 null. 的类Address的实例WebProxy。 当请求使用此状态下的 WebProxy 实例时，不会使用代理发送请求。

该方法 GetDefaultProxy 返回一个类的 WebProxy 实例，该类的 Address实例 BypassProxyOnLocal和 BypassList 属性设置为本地计算机使用的值。

该方法 Select 根据 Internet 和配置文件设置的组合返回类的 WebProxy 实例及其属性集。

该 WebProxy 类支持自动检测和执行代理配置脚本。 此功能也称为 Web 代理自动发现（WPAD）。 使用自动代理配置时，通常命名为Wpad.dat的配置脚本必须位于、下载、编译和运行。 如果这些操作成功，脚本将返回可用于请求的代理。

构造函数

名称	说明
WebProxy()	初始化类的 WebProxy 空实例。
WebProxy(SerializationInfo, StreamingContext)	已过时. 使用以前序列化的内容初始化类的 WebProxy 实例。
WebProxy(String, Boolean, String[], ICredentials)	使用指定的 URI、绕过设置、要绕过的 URI 列表和凭据初始化类的新实例 WebProxy 。
WebProxy(String, Boolean, String[])	使用指定的 URI、绕过设置和要绕过的 URI 列表初始化类的新实例 WebProxy 。
WebProxy(String, Boolean)	使用指定的 URI 和绕过设置初始化类的新实例 WebProxy 。
WebProxy(String, Int32)	使用指定的主机和端口号初始化类的新实例 WebProxy 。
WebProxy(String)	使用指定的 URI 初始化类的新实例 WebProxy 。
WebProxy(Uri, Boolean, String[], ICredentials)	使用指定的Uri实例、绕过设置、要绕过的 URI 列表和凭据初始化类的新实例WebProxy。
WebProxy(Uri, Boolean, String[])	使用指定的Uri实例、绕过设置和要绕过的 URI 列表初始化类的新实例WebProxy。
WebProxy(Uri, Boolean)	使用Uri实例初始化类的新实例WebProxy并绕过设置。
WebProxy(Uri)	从指定的Uri实例初始化类的新实例WebProxy。

属性

名称	说明
Address	获取或设置代理服务器的地址。
BypassArrayList	获取不使用代理服务器的地址列表。
BypassList	获取或设置不使用代理服务器的地址数组。
BypassProxyOnLocal	获取或设置一个值，该值指示是否绕过本地地址的代理服务器。
Credentials	获取或设置要提交到代理服务器进行身份验证的凭据。
UseDefaultCredentials	获取或设置一个 Boolean 值，该值控制是否 DefaultCredentials 随请求一起发送。

方法

名称	说明
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetDefaultProxy()	已过时. 读取 Internet 选项非动力学代理设置。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)	使用 SerializationInfo 序列化目标对象所需的数据填充数据。
GetProxy(Uri)	返回请求的代理 URI。
GetType()	获取当前实例的 Type。 (继承自 Object)
IsBypassed(Uri)	指示是否对指定的主机使用代理服务器。
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)

显式接口实现

名称	说明
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	创建系统用于序列化 WebProxy 对象的序列化数据和上下文。