WebClient类 详细使用教程
原文链接：https://blog.csdn.net/nutian/article/details/2913670 https://blog.csdn.net/m0_58015531/article/details/131322801
WebClient类
如果只想从特定的URI请求文件，则可以使用的最简单.NET基类就是System.Net.WebClient。这个类是非常高层的类，它主要用于执行带有一个或两个命令的操作。.NET Framework目前支持以http:、https:和file:标识符开头的URI。
注意：
术语URL(统一资源定位符)在新的技术规范中已不再使用，现在使用的是URI(统一资源标识符)。URI的含义大致与URL相同，但URI更通用，因为它不隐含正在使用的协议，如HTTP或FTP。
它支持同步和异步操作，并且可以使用多个线程同时下载或上传数据。
WebClient的优点包括：
简单易用，适合快速开发。
支持异步操作，可以提高程序的响应速度。
支持多线程操作，可以提高下载或上传数据的速度。
WebClient的缺点包括：
不支持自定义HTTP请求头。
不支持HTTP响应的详细信息，如状态码和响应头。
不支持流式传输，只能一次性下载或上传整个文件。
31.1.1 下载文件
使用WebClient类从Web站点下载文件时有两种方法，具体使用哪一种方法取决于文件内容的处理方式。如果只想把文件保存到磁盘上，就应该调用DownloadFile()方法。这个方法有两个参数：即文件的URI和保存所请求的数据的位置(路径和文件名)：
WebClient Client = new WebClient();
Client.DownloadFile("http://www.Wrox.com/index.asp", "index.htm");
更为常见的是，应用程序需要处理从Web站点检索到的数据。为此，要使用OpenRead()方法，这个方法返回一个Stream引用。然后，就可以把数据从数据流中提取到内存中：
WebClient Client = new WebClient();
Stream strm = Client.OpenRead("http://www.Wrox.com/default.asp");
31.1.2 基本的Web客户示例
第一个示例将阐述怎样使用WebClient.OpenRead()方法。在这个示例中，我们将把下载的页面显示在ListBox控件中。把项目创建为标准的Windows C#应用程序，添加一个名为listBox1的列表框，将其docking 属性设置为DockStyle.Fill。在文件的开头，需要在using指令中添加System.Net和System.IO命名空间，然后对主窗体的构造函数进行以下改动：
public Form1()
{
InitializeComponent();
System.Net.WebClient Client = new WebClient();
Stream strm = Client.OpenRead("http://www.wrox.com");
StreamReader sr = new StreamReader(strm);
string line;
while ( (line=sr.ReadLine()) != null )
{
listBox1.Items.Add(line);
}
strm.Close();
}
在这个示例中，把System.IO命名空间的StreamReader类与网络数据流关联起来。这样，就可以使用更加有效的高层方法，例如ReadLine()方法，从数据流中以文本的形式获取数据。第30章讨论了把数据移动抽象化为数据流概念的优点，这个示例就充分体现出了这些优点。
这个示例的运行结果如图31-1所示。
图 31-1
在WebClient类中还有一个方法OpenWrite()，它可以返回一个可写的数据流，并把数据发送给URI。也可以指定该方法用于把数据发送给主机；默认的方法是POST。下面的代码段假定在本地机器上有一个可写的目录accept，这段代码在该目录下创建文件newfile.txt，其内容为"Hello World"：
WebClient webClient = new WebClient();
Stream stream = webClient.OpenWrite("http://localhost/accept/newfile.txt","PUT");
StreamWriter streamWriter = new StreamWriter(stream);
streamWriter.WriteLine("Hello World");
streamWriter.Close();
31.1.3 上传文件
WebClient类还提供了UploadFile()方法和UploadData()方法。UploadFile()方法用于把指定的文件上传到指定的位置，其中的文件名已经给出；而UploadData()方法用于把二进制数据上传至指定的URI，那些二进制数据是作为字节数组提供的(还有一个DownloadData()方法，用于从URI中检索字节数组)：
WebClient client = new WebClient();
client.UploadFile("http://www.ourwebsite.com/NewFile.htm", "C://WebSiteFiles//NewFile.htm");
byte [] image;
// code to initialise image so it contains all the binary data for
// some jpg file
client.UploadData("http://www.ourwebsite.com/NewFile.jpg", image);
