WebClient类的属性、方法与事件
Admin | 2017-2-15 10:09:01 | 被阅次数 | 5400
WebClient类提供向 URI 标识的资源发送数据和从 URI 标识的资源接收数据的公共方法。 其实就相当于创建一个请求客户端。可以获取网页和各种各样的信息，包括交互。
通过MSDN来看看WebClient类提供的功能。
一、WebClient类属性
1、BaseAddress 获取或设置 WebClient 发出请求的基 URI。
2、CachePolicy 对于此 WebClient 实例使用 WebRequest 对象获得的任何资源，获取或设置应用程序的缓存策略。
3、CanRaiseEvents 获取一个指示组件是否可以引发事件的值。 （继承自 Component。）
4、Container 获取 IContainer，它包含 Component。 （继承自 Component。）
5、Credentials 获取或设置发送到主机并用于对请求进行身份验证的网络凭据。
6、DesignMode 获取一个值，用以指示 Component 当前是否处于设计模式。 （继承自 Component。）
7、Encoding 获取和设置用于上载和下载字符串的 Encoding。
8、Events 获取附加到此 Component 的事件处理程序的列表。 （继承自 Component。）
9、Headers 获取或设置与请求关联的标头名称/值对集合。
10、IsBusy 了解是否存在进行中的 Web 请求。
11、Proxy 获取或设置此 WebClient 对象使用的代理。
12、QueryString 获取或设置与请求关联的查询名称/值对集合。
13、ResponseHeaders 获取与响应关联的标头名称/值对集合。
14、Site 获取或设置 Component 的 ISite。 （继承自 Component。）
15、UseDefaultCredentials 获取或设置 Boolean 值，该值控制 DefaultCredentials 是否随请求一起发送。
二、WebClient类方法
1、CancelAsync 取消一个挂起的异步操作。
2、CreateObjRef 创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 （继承自 MarshalByRefObject。）
3、Dispose 已重载。
4、DownloadData 已重载。 以 Byte 数组形式通过指定的 URI 下载。
5、DownloadDataAsync 已重载。 以 Byte 数组形式下载指定的资源。这些方法不会阻止调用线程。
6、DownloadFile 已重载。 将具有指定 URI 的资源下载到本地文件。
7、DownloadFileAsync 已重载。 将指定的资源下载到本地文件。这些方法不会阻止调用线程。
8、DownloadString 已重载。 以 String 形式下载请求的资源。可以以包含 URI 的 String 或 Uri 的形式指定要下载的资源。
9、DownloadStringAsync 已重载。 下载以 String 或 Uri 形式指定的资源。这些方法不会阻止调用线程。
10、Equals 确定指定的 Object 是否等于当前的 Object。 （继承自 Object。）
11、Finalize 在通过垃圾回收将 Component 回收之前，释放非托管资源并执行其他清理操作。 （继承自 Component。）
12、GetHashCode 用作特定类型的哈希函数。 （继承自 Object。）
13、GetLifetimeService 检索控制此实例的生存期策略的当前生存期服务对象。 （继承自 MarshalByRefObject。）
14、GetService 返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 （继承自 Component。）
15、GetType 获取当前实例的 Type。 （继承自 Object。）
16、GetWebRequest 为指定资源返回一个 WebRequest 对象。
17、GetWebResponse 已重载。 返回对指定 WebRequest 的 WebResponse。
18、InitializeLifetimeService 获取控制此实例的生存期策略的生存期服务对象。 （继承自 MarshalByRefObject。）
19、MemberwiseClone 已重载。
20、OnDownloadDataCompleted 引发 DownloadDataCompleted 事件。
21、OnDownloadFileCompleted 引发 DownloadFileCompleted 事件。
22、OnDownloadProgressChanged 引发 DownloadProgressChanged 事件。
23、OnDownloadStringCompleted 引发 DownloadStringCompleted 事件。
24、OnOpenReadCompleted 引发 OpenReadCompleted 事件。
25、OnOpenWriteCompleted 引发 OpenWriteCompleted 事件。
26、OnUploadDataCompleted 引发 UploadDataCompleted 事件。
27、OnUploadFileCompleted 引发 UploadFileCompleted 事件。
28、OnUploadProgressChanged 引发 UploadProgressChanged 事件。
29、OnUploadStringCompleted 引发 UploadStringCompleted 事件。
30、OnUploadValuesCompleted 引发 UploadValuesCompleted 事件。
31、OpenRead 已重载。 为从具有指定 URI 的资源下载的数据打开一个可读的流。
32、OpenReadAsync 已重载。 打开包含指定资源的可读流。这些方法不会阻止调用线程。
33、OpenWrite 已重载。 打开一个流以将数据写入具有指定 URI 的资源。
34、OpenWriteAsync 已重载。 打开一个流以将数据写入指定的资源。这些方法不会阻止调用线程。
35、ToString 返回包含 Component 的名称的 String（如果有）。不应重写此方法。 （继承自 Component。）
36、UploadData 已重载。 将数据缓冲区上载到具有指定 URI 的资源。
37、UploadDataAsync 已重载。 将数据缓冲区上载到由 URI 标识的资源。此方法不会阻止调用线程。
38、UploadFile 已重载。 将本地文件上载到具有指定 URI 的资源。
39、UploadFileAsync 已重载。 将指定的本地文件上载到指定的资源。这些方法不会阻止调用线程。
40、UploadString 已重载。 将指定的字符串上载到指定的资源。
41、UploadStringAsync 已重载。 将指定的字符串上载到指定的资源。这些方法不会阻止调用线程。
42、UploadValues 已重载。 将名称/值集合上载到具有指定 URI 的资源。
43、UploadValuesAsync 已重载。 将指定的名称/值集合上载到指定的 URI 所标识的资源。这些方法不会阻止调用线程。
三、WebClient类事件
1、Disposed 当通过调用 Dispose 方法释放组件时发生。 （继承自 Component。）
2、DownloadDataCompleted 在异步数据下载操作完成时发生。
3、DownloadFileCompleted 在异步文件下载操作完成时发生。
4、DownloadProgressChanged 在异步下载操作成功转换部分或全部数据后发生。
5、DownloadStringCompleted 在异步资源下载操作完成时发生。
6、OpenReadCompleted 在以下异步操作完成时发生，该操作打开包含某个资源的流。
7、OpenWriteCompleted 在打开流以将数据写入资源的异步操作完成时发生。
8、UploadDataCompleted 在异步数据上载操作完成时发生。
9、UploadFileCompleted 在异步文件上载操作完成时发生。
10、UploadProgressChanged 在异步上载操作成功转换部分或全部数据后发生。
11、UploadStringCompleted 在异步字符串上载操作完成时发生。
12、UploadValuesCompleted 在名称/值集合的异步上载完成时发生。