WebProxy 类

定义

命名空间:

System.Net

程序集:

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

示例

下面的代码示例使用 实例WebProxy设置HttpClient实例。 实例 HttpClient 使用 代理连接到外部 Internet 资源。 (有关使用 WPAD 功能的示例，请参阅 class. IWebProxyScript )

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

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

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函数返回 类的实例，WebProxyAddress其属性设置为 null。 当请求使用处于此状态的 WebProxy 实例时，不会使用代理发送请求。

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

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

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

构造函数

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

属性

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 对象时所使用的序列化数据和上下文。