1编写目的
为了方便用户使用大文件上传组件,特写使用说明书,以指明调用组件的接口,操作流程和注意事项。
2背景
由于ASP.NET在上传文件时,是全部装入服务器内存,在上传文件时,消耗服务器资源较多,且不能提供上传进度显示,由于消耗服务器资源较多,所以ASP.NET上传文件时往往大小受到限制。此组件解决了所有这些问题
3定义
大文件:大文件主要意思是指大小不受限制,
Web.config:是ASP.NET的配置文件。
4功能
所有需要用ASP.NET上传文件的地方,均可以使用本组件。本组件可以解除ASP.NET对上传文件大小的限制,同时提供上传进度提示,用户还可以选择中断上传过程。减少对服务器资源的消耗(经测试,服务器资源消耗与运行普通ASP.NET页面相差无几)
5、组件主要类及操作:
5.1 BigFileUploadModuleHandle
大文件上传处理模块,用于在客户端请求发送到服务器上后,分析请求内容,如果是上传文件,则在IIS将数据出发送到ASP.NET的管道中时,读取数据,写入文件,并重新组织请求内容,重新组织的内容是去掉了文件内容的请求内容。页面在接收到请求后,除文件上传控件不能读取文件内容外,其它组件的属性可以正常访问。
5.2 DataReader
请求数据分析和文件写入。
5.3 UpFileInfo
上传文件属性结构,供组件内部使用。
5.4 UploadContext
文件上传环境,组件在使用时,主要使用此类。具体有以下方法和属性:
UploadContext:构造函数,需传入文件上传页面对象和文件临时存放目录。外部不能直接调用些构造函数,要构建文件上传环境,需调用UploadContextFactory的提供的静态方法
TmepFileDir:获取和设置上传临时文件存放路径
FileNames上传的文件名列表
TotalLength发送信息总长度,包括页面所有控件请求内容
Readedlength已接收的信息长度 包括面页控件请求内容
StartReadDateTime开始接收时间
FileConIds页面文件上传控件ID列表,对文件上传控件在服务器端运行时,为控件的UniqueID
GUID:上传文件唯一标志
Abort :设置和读取是否中断上传过程
Ratio上传速率,返回每秒上传的字节数
FormatRatio获取格式化的上传速度,以适当的字节,K字节,M字节表示
LeftTime估计上传剩余时间,以秒为单位
FormatLeftTime获取格式上的上传剩余时间,适当的以小时,分钟,秒表示
CurrentFile当前正在处理的上传文件
Status上传状态
FormatStatus 以字符串格式,返回当前上传操作的状态
SaveFile另存上传的数据文件,此方法主要将文件从临时存放目录移到用户需要求的目录,由于采取移动文件办法,所以此方法调用成功后,临时文件对应文件将被移走。
GetFileNameByControl根据页面文件上传控件名称,获取上传的文件名
Dispose当前上下文环境中接收的所有文件
GetFileName :根据文件上传控件名称,获取对应的上传的文件。
5.5 UploadContextFactory
创建和获取文件上传环境。
InitUploadContext(System.Web.UI.Page page,string TempFileDir)根据页面对象和上传文件临时目录文件夹,获取一个文件上传上下文类实例
GetUploadContext根据页面发送的上传会话编号,获取文件上传上下文
GetUploadContext(string GUID)根据会话编号的GUID获取文件上传的上下文
Release在页面逻辑处理完成后,释放上传上下文,并删除临时文件
uploadStatus:文件上传状态枚举类
6 使用方法及注意事项
1、 将组件dll复制到应用系统bin目录,然后再VS.NET中引用本组件,
2、 在web.config增加ASP.NET处理模块
<httpModules>
<add name="BigFileUploadModuleHandle " type="HelpSoft.BigFileUploadModuleHandle,BigFileUploadHandle" />
</httpModules>
3、 在要上传文件的asp.net页面的页面装入事件中或初始化事件中,初始化文件上传环境,注册文件上传存放的临时文件夹,如下面代码:
private void Page_Load(object sender, System.EventArgs e)
{
UploadContext context = UploadContextFactory.InitUploadContext(this, @"c:" myupload"");
}
提示:A、文件存放目录要求设置相应的访问权限,目录必须存在
B、初始化上传环境后,页面须在一天内发送文件。否则上传环境失效。
C、初始化上传环境时,组件将在页面内注册隐藏域,记录上传会话唯一标志。隐藏域命名为UploadID,页面不能有同名控件。
D、需要上传文件表单编码方式必须为multipart/form-data,(对于文件上传控件作为服务器端控件运行时,系统会自动加入此编码方式,否则需用户手工添加)
E、要使本上传组件生效,必须在页面访问时初始化上传环境,和设置表单编码方式,反之,如不希望本组件对特定页面生效,只可取消前两条件之一。
4、 在文件上传提交事件中,直接从上传文件环境工厂类中获取文件上传环境,进一步获取上传的文件信息。类似代码如下:
UploadContext context = UploadContextFactory.GetUploadContext();
string FileName = context.GetFileNameByControl(resFile.UniqueID);
string filePath=@"c:"workdir";
if (context.SaveFile(resFile.UniqueID,filePath+FileName))
{
UploadContextFactory.Release();
}
提示:A、根据控件名获取对应的上传文件信息时,对服务器控件需要传入控件唯一标志,对非服务器控件,需传入控件名称。
B、对文件另存时的目录访问权限,是否存在、可用空间大小,由页面调用者检查处理。如此类型错误发生,系统将引发对应异常。
C、如没找到控件对应文件(可能是客户端没有指定文件或传的控件标志有误)、临时目录中对应文件也不存在(已成功调用过此方法,文件已被移走),本方法将返回假,操作成功后,方法返回真。
D、UploadContextFactory.Release()将从系统缓存中清除上传环境对象,将不能用GetUploadContext方法获取上传环境,但已取得的上传环境仍然可用。
5、 读取文件上传进度时,需另建一个ASPX页面,读取进度主要是根据上传文件的会话唯一标志,从系统缓存中(通过GetUploadContext(string GUID)方法))获取上传文件环境,访问此环境类,即可以获取文件上传开始时间、信息总长度、当前已传送信息长度、速度、估计剩余时间等信息。系统再使用定时刷新的办法,不断获得上传进度信息,即可形成上传进度提示。
进度显示可以使用XML无回刷新方式,也可以使用页面定时刷新方式。
6、 要在传输过程中,中断传输入过程,只需用会话唯一标志,获取上传环境,将一上传环境的abort属性设为真,系统将主动与客户端断开连接,中断上传过程,同时页面提交的其它数据也将取消。