Net2.0中新增了很多组件,WebClient就是其中一个,功能也很强大,今天拿WebClient做了一个小实验,只用到了一些很简单的功能就可以实现以前不好实现的功能,很方便。

    简单介绍一下WebClient:
    WebClient 类提供向 URI 标识的任何本地、Intranet 或 Internet 资源发送数据以及从这些资源接收数据的公共方法。
    WebClient 类使用 WebRequest 类提供对资源的访问。WebClient 实例可以通过任何已向 WebRequest.RegisterPrefix 方法注册的 WebRequest 子代访问数据。
    注意
    默认情况下,.NET Framework 支持以 http:、https:、ftp:、和 file: 方案标识符开头的 URI。 

    下面描述用于将数据上载到资源的 WebClient 方法: 
    OpenWrite  检索一个用于将数据发送到资源的 Stream。
    OpenWriteAsync  检索 Stream,它在不阻止调用线程的情况下将数据发送到资源。
    UploadData  将字节数组发送到资源,并返回包含任何响应的 Byte 数组。
    UploadDataAsync  在不阻止调用线程的情况下,将 Byte 数组发送到资源。
    UploadFile  将本地文件发送到资源,并返回包含任何响应的 Byte 数组。
    UploadFileAsync  在不阻止调用线程的情况下,将本地文件发送到资源。
    UploadValues  将 NameValueCollection 发送到资源,并返回包含任何响应的 Byte 数组。
    UploadValuesAsync  在不阻止调用线程的情况下,将 NameValueCollection 发送到资源,并返回包含任何响应的 Byte 数组。
    UploadString  在不阻止调用线程的情况下,将 String 发送到资源。
    UploadStringAsync  在不阻止调用线程的情况下,将 String 发送到资源。 

    下面描述从资源下载数据的 WebClient 方法: 
    OpenRead  从资源以 Stream 的形式返回数据。
    OpenReadAsync  在不阻止调用线程的情况下,从资源返回数据。
    DownloadData 从资源下载数据并返回 Byte 数组。
    DownloadDataAsync  在不阻止调用线程的情况下,从资源下载数据并返回 Byte 数组。
    DownloadFile  从资源将数据下载到本地文件。
    DownloadFileAsync  在不阻止调用线程的情况下,将数据从资源下载到本地文件。
    DownloadString  从资源下载 String 并返回 String。
    DownloadStringAsync  在不阻止调用线程的情况下,从资源下载 String。 

    您可以使用 CancelAsync 方法取消尚未完成的异步操作。
    默认情况下,WebClient 实例不发送可选的 HTTP 报头。如果您的请求需要可选报头,必须将该报头添加到 Headers 集合。例如,要在响应中保留查询,必须添加用户代理报头。此外,如果用户代理标头丢失,服务器可能返回 500(内部服务器错误)。
    在 WebClient 实例中,AllowAutoRedirect 设置为 true。
    给继承者的说明 派生类应调用 WebClient 的基类实现,以确保派生类按预期方式工作。

    实现源码为:

  1. using System;
  2. using System.Collections.Generic;
  3. using System.ComponentModel;
  4. using System.Data;
  5. using System.Drawing;
  6. using System.Text;
  7. using System.Windows.Forms;
  8. using System.Net;
  9. using System.IO;
  10. namespace wiindowsFormsApplication
  11. {
  12.     public partial class Form1 : Form
  13.     {
  14.         public Form1()
  15.         {
  16.             InitializeComponent();
  17.             this.textBox1.Text = @"http://dl-sh-ocn-1.pchome.net/0d/bx/koomail50b8.rar";
  18.         }
  19.         WebClient webClient = new WebClient();
  20.         private void btn_down_Click(object sender, EventArgs e)
  21.         {
  22.             
  23.             if (webClient.IsBusy)//是否存在正在进行中的Web请求
  24.             {
  25.                 webClient.CancelAsync();
  26.             }
  27.             //为webClient添加事件
  28.             webClient.DownloadProgressChanged +=new DownloadProgressChangedEventHandler(webClient_DownloadProgressChanged);
  29.             webClient.DownloadFileCompleted+=new AsyncCompletedEventHandler(webClient_DownloadFileCompleted);
  30.             //开始下载
  31.             webClient.DownloadFileAsync(new Uri(this.textBox1.Text), "aa.rar");
  32.         }
  33.         
  34.         private void webClient_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
  35.         {            
  36.             this.progressBar1.Value = e.ProgressPercentage;
  37.             this.lbl_pro.Text = e.ProgressPercentage.ToString() + "%";
  38.             this.lbl_detail.Text = string.Format("正在下载文件,完成进度{0}/{1}(字节)"
  39.                                 ,e.BytesReceived
  40.                                 ,e.TotalBytesToReceive);
  41.         }
  42.         private void webClient_DownloadFileCompleted(object sender, AsyncCompletedEventArgs e)
  43.         {
  44.             if (e.Cancelled)
  45.                 MessageBox.Show("下载被取消!");
  46.             else
  47.                 MessageBox.Show("下载完成!");
  48.         }
  49.         private void btn_cancel_Click(object sender, EventArgs e)
  50.         {
  51.             this.webClient.CancelAsync();
  52.             this.webClient.Dispose();
  53.         }
  54.     }
  55. }

运行界面: