C#（99）：WebClient实现上传下载 、System.Uri类

一、概述

System.Net.WebClient属于高层类、使用简单。均支持异步版本。支持http,https,fpt,files等URI。

建议不要将 WebClient 类用于新的开发。Net4.5及以上请改用 System.Net.Http.HttpClient 类。

二、下载

1、OpenRead：打开一个可读的Stream。

对于FTP资源，默认使用RETR命令；对于HTTP资源，默认使用Get方法。

Stream= client.OpenRead(serverUri)：

举例

WebClient client = new WebClient();
client.Headers.Add("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");
client.Encoding = Encoding.GetEncoding("gb2312");
client.Credentials = new NetworkCredential("csp", "welcome");

Stream data = client.OpenRead(url);//OpenRead为下载的数据打开一个只读的流
StreamReader reader = new StreamReader(data, Encoding.GetEncoding("gb2312"));
sting s = reader.ReadToEnd();
reader.Close();
return s;

2、DownloadData：以byte[]形式下载资源。

byte[] data= client.DownloadData(serverUri)：

3、DownloadFile：将资源下载在本地文件。

void client.DownloadFile(serverUri,localFile)：

4、DownloadString：以string的形式下载资源。

string content =client.DownloadString(serverUri)：

5、事件

1. DownloadProgressChanged事件：
2. Download***Completed事件

6、获取下载网址的真实文件名

获取http头部信息的内容。

Content-disposition 是 MIME 协议的扩展，MIME 协议指示 MIME 用户代理如何显示附加的文件。

Content-disposition其实可以控制用户请求所得的内容存为一个文件的时候提供一个默认的文件名，文件直接在浏览器上显示或者在访问时弹出文件下载对话框。
形如：”Content-Disposition: attachment;filename=FileName.txt“。

当你在响应类型为application/octet- stream情况下使用了这个头信息的话，那就意味着你不想直接显示内容，而是弹出一个"文件下载"的对话框

WebClient client = new WebClient();
byte[] data = client.DownloadData(fileUrl);
var mc = Regex.Matches(Server.UrlDecode(client.ResponseHeaders["Content-Disposition"]), @"filename=(.+)");
string filename = mc[0].Groups[1].Value;

三、上传

1、OpenWrite：打开一个可写的流。

对于FTP资源，默认使用STOR命令；对于HTTP资源，默认使用POST方法。

Strean =client.OpenWrite(serverUri);

2、UploadData：将byte[]数据上传到serverUri。

byte[] =client.UploadData(serverUri,byte[]);

3、UploadFile：将本地文件上传到serverUri。

byte[] =client.UploadFile(serverUri,localFile);

举例：

WebClient client = new WebClient();
client.Encoding = Encoding.UTF8;
client.Credentials = new NetworkCredential("csp", "welcome");
client.UploadProgressChanged += new UploadProgressChangedEventHandler(UploadProgressCallback);
client.UploadFileCompleted += new UploadFileCompletedEventHandler(UploadFileCompletedCallback);

client.UploadFileAsync(new Uri(uriString + Path.GetFileName(localfileName)), null, localfileName, progressbarfrom);


/// <summary>
/// 上传过程处理
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private static void UploadProgressCallback(object sender, UploadProgressChangedEventArgs e)
{
    (e.UserState as ProgressBar).Value = e.ProgressPercentage;
}

private static void UploadFileCompletedCallback(object sender, UploadFileCompletedEventArgs e)
{
    if (e.Error == null)
        MessageBox.Show("完成上传");
    else
        throw e.Error;
}

4、UploadValues：将指定的名/值集合到serverUri。

byte[] =client.UploadValues(serverUri,namevalueCollection);

5、事件：

1. UploadProgressChanged：e.ProcessPercentage,e.TatalBytesToReceive,e.BytesReceived;
2. Upload***Completed: e.Cancelled,e.Error,E.UserState;

四、System.Url类（统一资源表示符）

Uri url=new Uri(”http://www.mi.com:2165/somFolder/someFile.htm?order=true”);

• OriginalString    获取传递给 Uri 构造函数的原始 URI 字符串。http://www.mi.com:2165/somFolder/someFile.htm?order=true
• Scheme    获取此 URI 的方案名称。http
• IsFile    获取一个值，该值指示指定的 Uri 是否为文件 URI。false
• Host    获取此实例的主机部分。www.mi.com
• HostNameType    获取 URI 中指定的主机名的类型。DNS
• Port    获取此 URI 的端口号。2105
• IsDefaultPort    获取一个值，该值指示 URI 的端口值是否为此方案的默认值。false
• AbsolutePath    获取 URI 的绝对路径。/somFolder/someFile.htm
• Query    获取指定 URI 中包括的任何查询信息。?order=true
• PathAndQuery    获取用问号 (?) 分隔的 AbsolutePath 和 Query 属性。/somFolder/someFile.htm?order=true