笔记6：WebClient 类 一个更简捷的类

WebClient类设计用于存取时指定URI的资源，并且定义上传及下载数据所需的方法。

WebClient类比WebRequest及 WebResponse这两个类以更简便的方式达到相同的效果。

一、使用WebClient类

WebClient是一个无法被继承的类，提供两种比较重要的方法：

DownloadData( ) 从指定的URI下载数据

DownloadFile( )从指定的URI下载文件

DownloadData( ) 参数可是地址字串，或URI对象

Public Function DownloadData ( address As String ) As Byte( )
Public Function DownloadData ( address As Uri ) As Byte( )

返回一个byte类数组对象，其中包含下载的数据内容，紧接着将其直接写入文件或是其他的数据流进行保存即可。

DownloadFile( ) 接收两个参数，参数address代表从网络上下载文件的位置, fileName是下载的数据内容所要保存的文件位置名称

Public Sub DownloadFile( ByVal address As String , By Val fileName As String )

举例：

Imports System.Text
Imports System.Net

Public Class Form1
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
Dim wc As New WebClient
Dim bytWeb() As Byte

'获取网页源代码
bytWeb = wc.DownloadData(txtAddress.Text)
txtContent.Text = Encoding.Default.GetString(bytWeb, 0, bytWeb.Length)

'直接将源代码保存到本地文件中
wc.DownloadFile(txtAddress.Text, txtSaveFile.Text)
End Sub
End Class

二、取得数据流对象

WebClient类提供方法OpenRead，将结果以Stream对象的类返回。

Public Function OpenRead ( ByVal address As String ) As Stream

在下载address网址的网络资源，只要读取其Stream对象，应用程序便可以取得所下载的内容。

举例：

Imports System.Net
Imports System.IO

Public Class Form1
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
Dim wc As New WebClient
Dim st As Stream
Dim sr As StreamReader

st = wc.OpenRead(txtAddress.Text) '取得下载流
sr = New StreamReader(st)
txtContent.Text = sr.ReadToEnd

'如果想将流保存到文件：（代码略)
'建立 一个文件流filestream
'建立一个固定缓冲字节数组，用上面st循环读出
'一边读，一边将缓冲字节写入，直到结束
'参见， 笔记5：利用HttpWebResponse下载文件

End Sub
End Class