在程序中对文件进行压缩解压缩是很重要的功能,不仅能减小文件的体积,还能对文件起到保护作用。如果是生成用户可以下载的文件,还可以极大的减少网络流量并提升下载速度。最近在一个 C# 项目中用到了创建压缩文件的功能,在此和同学们分享一下使用心得。
SharpZipLib 库既然是很重要的用能,那么如果每个人在使用的时候都去用基本的 API 去实现一遍显然不符合效率至上的生产要求。作为比较有经验的开发人员相信您一定会在第一时间去搜寻一款功能丰富,口碑良好的开源类库来完成相关的工作。在 .NET 平台上,要操作压缩文件的话您的第一选择一定是 SharpZipLib。SharpZipLib 是一个开源的基于 .NET 平台的压缩、解压缩类库。特点是经过长期的开发和使用现在已经变得非常的稳定,可以放心的应用到产品中。下面我们就通过实例来介绍如何使用它在 C# 代码中创建压缩文件,以及一些常见问题的处理方法。SharpZipLib 的下载请访问这里。编译也很简单,用 VisualStudio 打开直接编译就能成功。如果您想全面的掌握 SharpZipLib 的使用方法,建议您直接去读 SharpZipLib 的文档,本文仅介绍基本的用法和一些使用心得。
基本压缩操作SharpZipLib 支持 Zip,Gzip,Tar,BZip2 等主流的压缩格式。本文以 zip 格式做介绍,其它格式的用法也都差不太多。对于 zip 压缩格式,创建压缩文件时用到的类型主要为 ZipOutputStream 和 ZipEntry。下面通过几个典型的用例来介绍它们的用法。
读取硬盘上的文件并加入压缩包这可能是最简单也最常见的用法了,直接上代码:
//生成的压缩文件为test.zip using (FileStream fsOut = File.Create("test.zip")) { //ZipOutputStream类的构造函数需要一个流,文件流、内存流都可以,压缩后的内容会写入到这个流中。 using (ZipOutputStream zipStream = new ZipOutputStream(fsOut)) { //准备把G盘根目录下的vcredist_x86.exe文件添加到压缩包中。 string fileName = @"G:\vcredist_x86.exe"; FileInfo fi = new FileInfo(fileName); //entryName就是压缩包中文件的名称。 string entryName = "vcredist_x86.exe"; //ZipEntry类代表了一个压缩包中的一个项,可以是一个文件,也可以是一个目录。 ZipEntry newEntry = new ZipEntry(entryName); newEntry.DateTime = fi.LastWriteTime; newEntry.Size = fi.Length; //把压缩项的信息添加到ZipOutputStream中。 zipStream.PutNextEntry(newEntry); byte[] buffer = new byte[4096]; //把需要压缩文件以文件流的方式复制到ZipOutputStream中。 using (FileStream streamReader = File.OpenRead(fileName)) { StreamUtils.Copy(streamReader, zipStream, buffer); } zipStream.CloseEntry(); //添加多个文件 //如果要压缩一个文件夹,就是通过遍历添加文件夹下所有的文件 string fileName2 = @"G:\share\web.dll"; FileInfo fi2 = new FileInfo(fileName2); //文件在压缩包中的路径 string entryName2 = "share\\web.dll"; ZipEntry newEntry2 = new ZipEntry(entryName2); newEntry2.DateTime = fi2.LastWriteTime; newEntry2.Size = fi2.Length; zipStream.PutNextEntry(newEntry2); byte[] buffer2 = new byte[4096]; using (FileStream streamReader = File.OpenRead(fileName2)) { StreamUtils.Copy(streamReader, zipStream, buffer2); } zipStream.CloseEntry(); //使用流操作时一定要设置IsStreamOwner为false。否则很容易发生在文件流关闭后的异常。 zipStream.IsStreamOwner = false; zipStream.Finish(); zipStream.Close(); } }
代码并不复杂且添加了详细的注释,因此不再赘言。此时已经完成了把文件加入压缩包的功能,压缩包中的内容如下:
注意,web.dll 文件在 share 文件夹中。
把内存中的数据添加到压缩包有时我们要压缩的对象并不是磁盘上的文件,而是内存中的数据。比如数据库查询操作的结果中有一些字符串,希望把这些字符串写入到压缩包中的文本文件中。当然可以先把这些字符串保存到磁盘上的文件中,然后再通过前面例子中的方法写入压缩包,,这也可以完成任务,却不是高效的方法。首先磁盘 IO 很慢也很昂贵,另外在一些 web 应用环境中你是没有权限写文件的。这就要求我们直接把数据写入到压缩包中:
//我们有一个字符串,希望直接写入到压缩包中的City.csv文件中。 byte[] string1 = Encoding.UTF8.GetBytes("Washington,ShangHai,TianJin,DongJing"); using (FileStream fsOut = File.Create("test1.zip")) { using (ZipOutputStream zipStream = new ZipOutputStream(fsOut)) { ZipEntry entry = new ZipEntry("City.csv"); entry.DateTime = DateTime.Now; zipStream.PutNextEntry(entry); //Write方法和前面用的StreamUtils.Copy方法差不多,不过这里操作的是byte数组。 zipStream.Write(string1, 0, string1.Length); zipStream.CloseEntry(); zipStream.IsStreamOwner = false; zipStream.Finish(); zipStream.Close(); } }