Winform文件下载之WinINet

简介:

在C#中,除了webclient我们还可以使用一组WindowsAPI来完成下载任务。这就是Windows Internet,简称 WinINet。本文通过一个demo来介绍WinINet的基本用法和一些实用技巧。 

  • 系列文章

Winform文件下载之WebClient

 

  • 接口介绍

相比WebClient的用法,Win32API在使用时可能会烦琐一些。所以先把用到的API简单介绍一下。

 

资源的初始化和释放

InternetOpen

这是需要调用的第一个方法,它会初始化内部数据结构,为后面的调用做准备。

InternetCloseHandle

这个方法用来关闭使用中打开的Internet句柄,释放资源。

 

建立到服务器的连接

InternetOpenUrl

这是一个通用的函数,应用程序可以用它来请求数据(只要是WinINet支持的协议就可以)。尤其是当我们仅仅想要通过一个URL获取数据,而不关心通信协议相关的内容时,这个接口就特别合适。该方法会解析参数中的URL字符串,然后建立到服务器的连接,并准备下载由RUL标识的数据。

 

检查响应信息

HttpQueryInfo

检索与HTTP请求相关的报头信息。主要是查看请求是否成功。

 

读取响应内容

InternetReadFile

从 InternetOpenUrl打开的句柄中读取数据。

 

  • 下载过程

这里我们只介绍下载过程中的关键环节,完整的过程请参考本文的demo。

 

InternetOpenUrl

当请求与服务器建立连接时,我们重点考虑三个问题:请求的url,是否使用 RELOAD 标识, 客户端是否支持gzip压缩。

 

请求的url不用多说,这里直接请求一个http url.

 

我们不希望拿到客户端缓存中的数据,所以希望每次请求都能够从服务器重新下载。此时需要为InternetOpenUrl方法传入INTERNET_FLAG_RELOAD 标识。

 

当前绝大多数的web服务器都是支持gzip压缩的,我们的客户端当然也要能够解压缩服务器传回来的gzip格式的数据。所以我们要在请求中告诉服务器,客户端是能够处理gzip数据的。只有这样,服务器才会主动的返回gzip格式的数据。

代码如下:

?
1
2
3
4
5
6
7
string  referer =  "Referer: xxxxxx\nAccept-Encoding: gzip" ;
 
// INTERNET_FLAG_RELOAD -> 0x80000000
 
// 跳过缓存,强制从原始的服务器下载数据
 
hInetFile = NativeMethods.InternetOpenUrl( this ._hInet, uri.AbsoluteUri, referer, referer.Length, 0x80000000, IntPtr.Zero);

  

 

HttpQueryInfo

接下来我们开始检查前面发送的请求返回的header中的信息。主要是:请求的资源是否存在,返回的数据有多长,返回的文件的原始名称是什么,返回的数据是以什么格式被压缩的。

 

我们先要通过检查返回的状态码来确定请求是否成功,也就是返回的是不是200。

?
1
2
3
4
5
6
7
8
9
byte [] content =  new  byte [BufferSize];
 
int  count = BufferSize;
 
int  temp = 0;
 
NativeMethods.HttpQueryInfo(hInetFile, 19, content,  out  count,  out  temp)
 
statuscode = Encoding.Unicode.GetString(content, 0, count);

  

正确返回时,statuscode应该是 “200”。

不要对HttpQueryInfo的第二个参数感到奇怪,为了获得请求的返回状态我们就得传入19。你可以参考Query Onfo Flags 。

用类似的方法可以得到返回数据的长度,原始的文件名称,返回数据的格式。

 

InternetReadFile

前面一切顺利的话就可以读取数据了。这个方法本身没什么可说的,但出于简化操作的目的,笔者对InternetReadFile进行了简单的封装。创建了一个继承自Stream的类MyInternetReadStream。在重写的 Read方法中调用InternetReadFile,并且添加了一个回调方法用来计算下载进度等信息。下面是代码概要,完整代码请参考demo。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
public  override  int  Read( byte [] buffer,  int  offset,  int  count)
 
{
 
     int  dwNumberOfBytesToRead = Math.Min(BufferSize, count);
 
     int  length = 0;
 
     NativeMethods.InternetReadFile( this ._hInetFile,  this ._localBuffer,
  dwNumberOfBytesToRead,  out  length)
 
     Array.Copy( this ._localBuffer, 0, buffer, offset, length);
 
     this ._bytesReadCallback(length,  this ._contentLength);
 
     return  length;
 
}

  

 

Gzip stream

前面我们提到,服务器可能返回的是经过gzip压缩的数据,这就需要我们先检查数据的格式。如果是gzip格式的数据就需要把它解压缩。其实这在C#中是很简单的,我们只要把刚才创建的MyInternetReadStream的实例传给GZipStream的构造函数,创建一个新的GZipStream实例就可以了。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
private  Stream GetInternetStream(IntPtr hInetFile)
 
{
 
     //检查数据是不是gzip格式
 
     string  contentEncoding = MyWinInet.GetContentEncoding(hInetFile);
 
     if  (contentEncoding.IndexOf( "gzip" , StringComparison.OrdinalIgnoreCase) != -1)
 
     {
 
         return  new  GZipStream( this .ForGZipReadStream(hInetFile), CompressionMode.Decompress,  false );
 
     }
 
    
 
}
 
private  Stream ForGZipReadStream(IntPtr hInetFile)
 
{
return  new  MyWinInet.MyInternetReadStream(hInetFile, 
new  MyWinInet.MyInternetReadStream.BytesReadCallback( this .BytesReadCallback));
 
}

  

 

至于计算下载进度,实时的下载速度的实现和Winform文件下载之WebClient 中的实现基本相同,请参考上文,或者直接看本文的demo。

 

总结:相比WebClient,使用WinINet接口要烦琐不少。当然也有一定的优势,比如前文中提到的代理问题,WinINet的默认设置就能处理好Credentials。不过在笔者看来,更重要的是我们可以选用不同的方式去处理下载问题。



本文转自 powertoolsteam 51CTO博客,原文链接:http://blog.51cto.com/powertoolsteam/1768880,如需转载请自行联系原作者

相关文章
|
7月前
|
Web App开发 JavaScript 前端开发
使用 SAP UI5 FileUploader 控件上传本地文件试读版
使用 SAP UI5 FileUploader 控件上传本地文件试读版
44 1
|
8月前
|
C#
43【WinForm案例】WinForm做一个简单记事本
WinForm使用C#语言做一个简单的记事本,满足加载、保存文件,编辑文本、修改文本字体和颜色功能。
89 1
|
9月前
Fastadmin上传EXCEL
Fastadmin上传EXCEL
133 0
|
移动开发 前端开发 JavaScript
前端实现PDF文件下载的两种方式
前端实现PDF文件下载的两种方式
2021 0
前端实现PDF文件下载的两种方式
|
C# 存储
基于Winform、WPF等的客户端文件下载
  有时候,我们用C#写一些客户端应用程序需要从服务器下载一些资源,如图片、dll、配置文件等。下面就来说一下,在Winform及WPF中如何下载文件。 我们的资源大多放在自己的网站上,或者从其他网站下载资源,我们需要给客户端一个URL,先给出代码:     /// /// ...
960 0
|
Java Linux Windows
java实现office文件预览
喜欢的朋友可以关注下,粉丝也缺。        不知觉就过了这个久了,继上篇java实现文件上传下载后,今天给大家分享一篇java实现的对office文件预览功能。
3604 0