提供向 URI 标识的资源发送数据和从 URI 标识的资源接收数据的公共方法。
下表列出了由 WebClient 类型公开的成员。
公共构造函数
名称 说明
WebClient 初始化 WebClient 类的新实例。
页首
公共属性 （请参见 受保护的属性 ）
名称 说明
BaseAddress 获取或设置 WebClient 发出请求的基 URI。
CachePolicy 对于此 WebClient 实例使用 WebRequest 对象获得的任何资源，获取或设置应用程序的缓存策略。
Container 获取 IContainer，它包含 Component。（从 Component 继承）
Credentials 获取或设置发送到主机并用于对请求进行身份验证的网络凭据。
Encoding 获取和设置用于上载和下载字符串的 Encoding。
Headers 获取或设置与请求关联的标头名称/值对集合。
IsBusy 了解是否存在进行中的 Web 请求。
Proxy 获取或设置此 WebClient 对象使用的代理。
QueryString 获取或设置与请求关联的查询名称/值对集合。
ResponseHeaders 获取与响应关联的标头名称/值对集合。
Site 获取或设置 Component 的 ISite。（从 Component 继承）
UseDefaultCredentials 获取或设置 Boolean 值，该值控制 DefaultCredentials 是否随请求一起发送。
页首
受保护的属性
名称 说明
CanRaiseEvents 获取一个指示组件是否可以引发事件的值。（从 Component 继承）
DesignMode 获取一个值，用以指示 Component 当前是否处于设计模式。（从 Component 继承）
Events 获取附加到此 Component 的事件处理程序的列表。（从 Component 继承）
页首
公共方法 （请参见 受保护的方法 ）
名称 说明
CancelAsync 取消一个挂起的异步操作。
CreateObjRef 创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 （从 MarshalByRefObject 继承）
Dispose 已重载。 释放由 Component 占用的资源。 （从 Component 继承）
DownloadData 已重载。 以 Byte 数组形式通过指定的 URI 下载。
DownloadDataAsync 已重载。 以 Byte 数组形式下载指定的资源。这些方法不会阻止调用线程。
DownloadFile 已重载。 将具有指定 URI 的资源下载到本地文件。
DownloadFileAsync 已重载。 将指定的资源下载到本地文件。这些方法不会阻止调用线程。
DownloadString 已重载。 以 String 或 Uri 形式下载指定的资源。
DownloadStringAsync 已重载。 下载以 String 或 Uri 形式指定的资源。这些方法不会阻止调用线程。
Equals 已重载。 确定两个 Object 实例是否相等。 （从 Object 继承）
GetHashCode 用作特定类型的哈希函数。 （从 Object 继承）
GetLifetimeService 检索控制此实例的生存期策略的当前生存期服务对象。 （从 MarshalByRefObject 继承）
GetType 获取当前实例的 Type。 （从 Object 继承）
InitializeLifetimeService 获取控制此实例的生存期策略的生存期服务对象。 （从 MarshalByRefObject 继承）
OpenRead 已重载。 为从具有指定 URI 的资源下载的数据打开一个可读的流。
OpenReadAsync 已重载。 打开包含指定资源的可读流。这些方法不会阻止调用线程。
OpenWrite 已重载。 打开一个流以将数据写入具有指定 URI 的资源。
OpenWriteAsync 已重载。 打开一个流以将数据写入指定的资源。这些方法不会阻止调用线程。
ReferenceEquals 确定指定的 Object 实例是否是相同的实例。 （从 Object 继承）
ToString 返回包含 Component 的名称的 String（如果有）。不应重写此方法。 （从 Component 继承）
UploadData 已重载。 将数据缓冲区上载到具有指定 URI 的资源。
UploadDataAsync 已重载。 将数据缓冲区上载到由 URI 标识的资源。此方法不会阻止调用线程。
UploadFile 已重载。 将本地文件上载到具有指定 URI 的资源。
UploadFileAsync 已重载。 将指定的本地文件上载到指定的资源。这些方法不会阻止调用线程。
UploadString 已重载。 将指定的字符串上载到指定的资源。
UploadStringAsync 已重载。 将指定的字符串上载到指定的资源。这些方法不会阻止调用线程。
UploadValues 已重载。 将名称/值集合上载到具有指定 URI 的资源。
UploadValuesAsync 已重载。 将指定的名称/值集合上载到指定的 URI 所标识的资源。这些方法不会阻止调用线程。
页首
受保护的方法
名称 说明
Dispose 已重载。 释放由 Component 占用的资源。 （从 Component 继承）
Finalize 在通过垃圾回收将 Component 回收之前，释放非托管资源并执行其他清理操作。 （从 Component 继承）
GetService 返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 （从 Component 继承）
GetWebRequest 为指定资源返回一个 WebRequest 对象。
GetWebResponse 已重载。 返回对指定 WebRequest 的 WebResponse。
MemberwiseClone 已重载。 （从 MarshalByRefObject 继承）
OnDownloadDataCompleted 引发 DownloadDataCompleted 事件。
OnDownloadFileCompleted 引发 DownloadFileCompleted 事件。
OnDownloadProgressChanged 引发 DownloadProgressChanged 事件。
OnDownloadStringCompleted 引发 DownloadStringCompleted 事件。
OnOpenReadCompleted 引发 OpenReadCompleted 事件。
OnOpenWriteCompleted 引发 OpenWriteCompleted 事件。
OnUploadDataCompleted 引发 UploadDataCompleted 事件。
OnUploadFileCompleted 引发 UploadFileCompleted 事件。
OnUploadProgressChanged 引发 UploadProgressChanged 事件。
OnUploadStringCompleted 引发 UploadStringCompleted 事件。
OnUploadValuesCompleted 引发 UploadValuesCompleted 事件。
页首
公共事件
名称 说明
Disposed 当通过调用 Dispose 方法释放组件时发生。 （从 Component 继承）
DownloadDataCompleted 在异步数据下载操作完成时发生。
DownloadFileCompleted 在异步文件下载操作完成时发生。
DownloadProgressChanged 在异步下载操作成功转换部分或全部数据后发生。
DownloadStringCompleted 在异步资源下载操作完成时发生。
OpenReadCompleted 在以下异步操作完成时发生，该操作打开包含某个资源的流。
OpenWriteCompleted 在打开流以将数据写入资源的异步操作完成时发生。
UploadDataCompleted 在异步数据上载操作完成时发生。
UploadFileCompleted 在异步文件上载操作完成时发生。
UploadProgressChanged 在异步上载操作成功转换部分或全部数据后发生。
UploadStringCompleted 在异步字符串上载操作完成时发生。
UploadValuesCompleted 在名称/值集合的异步上载完成时发生。