在ASP.NET中利用SlickUpload上传大文件（续）

在上一篇中介绍了如何在ASP.NET中配置和使用SlickUpload控件，在这一篇周公将讲述关于SlickUpload的一些复杂配置，使其尽量满足我们复杂的业务逻辑。
在web.config文件中有个<slickUpload>节点，这个节点有有关SlickUpload的常见配置。
上传文件到服务器
如果我们要上传文件到服务器硬盘，可以配置如下（这个其实是周公在上一篇中的配置）：
<slickUpload> <uploadStreamProvider type="File" location="~/Files" existingAction="Overwrite" fileNameMethod="Custom" fileNameGenerator="MyFileNameGenerator"/> </slickUpload>

对这个节点的属性说明如下：
type属性（必需属性）：表示上传的文件保存到服务器硬盘。
location属性（必需属性）：上传文件的保存位置，在上面的配置中是保存到网站根目录下的Files目录下（“~/”是ASP.NET网站的根目录），注意需要对应目录的读写权限。
existingAction属性（可选属性）：指示当上传名称的文件如何处理，有Exception、Overwrite及Rename三个可能值，分别表示抛出异常、覆盖及重命名（添加一个数字后缀）处理。
fileNameMethod属性（可选属性）：指示上传的文件将以何种名称方式保存到服务器硬盘，有可选值：Client、Guid及Custom。分别表示保持客户端的名称不变、使用随机生成的GUID作为文件名（可以确保不会重复）及自行指定文件名。
fileNameGenerator属性（可选属性）：如果配置了fileNameMethod="Custom"就需要指定这个属性，这个属性的值是一个class的名称，这个名称是一个实现了Krystalware.SlickUpload.Providers.IFileNameGenerator接口的类，这个接口有一个待实现的方法GenerateFileName(UploadedFile file)。在上一篇的示例中周公在Web项目中的App_Code中添加了一个名为MyFileNameGenerator（这个类如果带有命名空间，则需要带命名空间指定，如NetSkycn.MyFileNameGenerator)，在这里代码周公想实现的是在上传的文件后添加文件上传时间后缀，代码如下：

using System; using System.Collections.Generic; using System.Linq; using System.Web; using Krystalware.SlickUpload; using Krystalware.SlickUpload.Providers; /// <summary> ///MyFileNameGenerator 的摘要说明 /// </summary> public class MyFileNameGenerator:IFileNameGenerator { public MyFileNameGenerator() { } #region IFileNameGenerator 成员 public string GenerateFileName(UploadedFile file) { string fileName = System.IO.Path.GetFileNameWithoutExtension(file.ClientName); string extension = System.IO.Path.GetExtension(file.ClientName); return string.Format("{0}{1}{2}", fileName, DateTime.Now.ToString("yyyy-MM-dd_hhmmss"), extension); } #endregion }
这样，当客户端上传一个“严厉打击伪国产软件.doc”的文件到服务器时，将可能会保存成“严厉打击伪国产软件2010-07-25_112533.doc”。
客户端编程支持
限制最大可上传文件个数
可以设置控件的MaxFiles属性，如下就是限制每次最多上传5个文件：
<kw:SlickUpload ID="SlickUpload1" runat="server" MaxFiles="5"> ........</<kw:SlickUpload>
如何在客户端操作SlickUpload控件的客户端控件
假如你SlickUpload服务器控件的ID是slickUpload，那么在客户端可以通过如下方式：

var slickUpload = kw.get("<%slickUpload.ClientID %>");
限制至少上传一个文件
下面以结合CustomValidator验证控件的例子来说明，首先编写客户端javascript代码，如下：

function Validate_SlickUploadRequiredFiles(source, args) { args.IsValid = (kw.get("<%=SlickUpload1.ClientID %>").get_Files().length > 0); }
然后再CustomValidator验证控件中作如下配置：

<asp:CustomValidator runat="server" ClientValidationFunction="Validate_SlickUploadRequiredFiles" Text="请至少选择一个文件上传！" />
定义在上传过程中客户端跳转的提示信息

<kw:SlickUpload ... ConfirmNavigateDuringUploadMessage="离开本页面将会导致取消本次上传！" ... />
文件上传类型验证
方法一
通过设置SlickUpload控件的ValidExtensions和InvalidExtensionMessage属性，如下：
<kw:SlickUpload ID="SlickUpload1" runat="server" ValidExtensions=".png,.gif,.jpg" InvalidExtensionMessage="请选择一个图片文件(*.png, *.gif, *.jpg)">
这样当用户选择了非图片文件之后将会看到下面的结果：

方法二
结合CustomValidator控件来验证，首先编写JavaScript函数：

function Validate_SlickUploadValidExtensions(source, args) { var files = kw.get("<%=SlickUpload1.ClientID %>").get_Files(); args.IsValid = true; for (var i = 0; i < files.length; i++) { if (!files[i].isValidExtension) { args.IsValid = false; return; } } }
然后在CustomValidator控件中指定用刚才编写的方法验证，如下：
<asp:CustomValidator runat="server" ClientValidationFunction="Validate_SlickUploadValidExtensions" Text="请选择图片文件 (*.png, *.gif, *.jpg)." />
说明
在本篇中讲述演示了如何将文件上传到服务器硬盘的相关配置，尽管在SlickUpload作者提供的文档中有讲述如何将文件保存到SQL Server服务器，但是这种方法非特殊场合并不推荐，使用情况较少，所以在这里并没有讲述如何配置。除此之外，本篇还讲述了如何在客户端限制上传文件的类型和文件个数。关于这篇和上篇文章的未尽之处请下载本人的示例代码，下载地址是：http://zhoufoxcn.download.youkuaiyun.com/（本人所使用的版本是VS2008SP1，如果你的VS版本低于或者高于我的VS版本的话，请按照本片和上篇对web.config做相应调整）。
本篇和上篇未尽之处请参考http://krystalware.com/Products/SlickUpload/处的说明文档，并且在那里还有Demo供下载（包括在ASP.NET MVC中的示例）。本文只是在《ASP.NET MVC2 IN ACTION》英文版时周公产生了兴趣，做了一些简单实验之后的体会和总结。
周公
2010-07-26