AspUpload的属性及其使用方法详细介绍

1、AspUpload的属性及其使用方法详细介绍1、CodePage As Long (Read/Write可以把表单的文本项目名和文件名的字符从指定的 CodePage转换为Unicode,比如表单是按UTF-8提交的,那么这个属性应该设置为65001。其他的如 51 (Cyrillic, 1255 (Hebrew, 1256 (Arabic等等。用法:< type=text/Java>attachEvent("", (AutoSizeDIV(CODE_7643 程序代码: Upload.CodePage = 65001-2、DetectMacBinary As

2、Boolean (Read/Write默认为True。这个属性用来控制是否检测上传的文件是MacBinary格式的,如果是则从中提取“data fork”。AspUpload 3.0 Beta 1. 不支持。用法:Upload.DetectMacBinary = False-3、Directory (Path As String, Optional SortBy, Optional Ascending As Object (Read-Only返回一个集合,这个集合包括指定目录的所有子目录和文件的引用。在这个集合里,子目录总是优先于文件.Path 可以包括通配符 * 和 ?。SortBy 可以是

3、: SORTBY_NAME (1, default. SORTBY_TYPE (2, SORTBY_SIZE (3, SORTBY_CREATIONTIME(4,SORTBY_LASTWRITETIME(5,and SORTBY_LASTAccessTIME (6. Ascending 默认为True。用法:Set Dir = Upload.Directory("c:path*.*", SORTBY_SIZEFor Each Item in Dir.Next-4、Expires As Date (Read-Only如果已经注册,返回9/9/9999,否则返回失效期。用法:R

4、esponse.Write Upload.Expires-5、Files As Object (Read-Only返回一个集合,这个集合包含有上传文件的引用。使用这个集合之前,必须调用Save或 SaveVirtual方法。要引用一个单个文件,可以使用从1开始的整数下标,或者相应的文件框的名称。要列举集合里的项目,可以使用For/Each 语句。用法:Set File = Upload.Files(1Set File = Upload.Files("FILE1"For Each File in Upload.Files.Next-6、Form As Object (Read

5、-Only返回一个集合,这个集合包括所有不是文件框的表单项目的引用。使用这个集合之前,必须调用Save或 SaveVirtual方法。要引用一个单个表单项目,可以使用从1开始的整数下标,或者相应的项目的名称。要列举集合里的项目,可以使用For/Each 语句。用法:Name = Upload.Form(1Name = Upload.Form("Name"For Each Item in Upload.FormResponse.Write Item.Next-7、IgnoreNoPost As Boolean (Read/Write当Upload.Save方法被脚本直接调用,

6、而不是通过表单提交时,可以避免 "Wrong Content-Type"这个错误。当表单和相应的上传脚本在同一个文件时,这个属性很有用。用法:Upload.IgnoreNoPost = True-8、OverwriteFiles As Boolean (Read/Write默认为True。如果设置为False,那么当文件名已经存在时,AspUpload会在原文件名后附加“(12”这种形式的字符。这个属性影响Save, SaveVirtual 和 File.SaveAs方法。用法:Upload.OverwriteFiles = False-9、PreserveFileTime

7、 As Boolean (Read/Write默认为Flase。如果设置为True,会试图保护上传文件的上次修改时间。这个属性只是客户端使用XUpload或者JUpload 的时候有用。当使用常规Form提交的时候,它没有任何作用。用法:Upload.PreserveFileTime = False-10、ProgressID As String (Read/Write上传进度条所用的,用来区分上传进程。用法:Upload.ProgressID = Request.QueryString("PID"-11、RegKey As String (Read/Write指定注册码,

8、如果没有指定,AspUpload会从系统注册表读取。用法:Upload.RegKey = "12345-67890-12345"-12、TotalBytes As Long (Read-Only返回上传的总字节数。只能在成功调用Save(SaveVirtual方法后调用这个属性。用法:Response.Write Upload.TotalBytes-13、TotalSeconds As Long (Read-Only返回上传持续的总时间。只能在成功调用Save(SaveVirtual方法后调用这个属性。用法:Response.Write Upload.TotalSecond

9、s-14、Version As String (Read-Only用法:Response.Write Upload.Version-UploadManager Methods=15、Sub CopyFile (FromPath As String, ToPath As String, Optional Overwrite 复制文件。Overwrite 默认为True。如果设置为False,当目标路径存在时,这个方法会失败。用法:Upload.CopyFile "c:path1file.ext", "c:path2file.ext"-16、Sub Crea

10、teDirectory (Path As String, Optional IgnoreAlreadyExists建立目录。IgnoreAlreadyExists 默认为False。如果设置为True,当目标路径存在时,这个方法不会报错。用法:Upload.CreateDirectory "c:dir1dir2", True-17、Sub CreateFile (Path As String建立一个空文件。用法:Upload.CreateFile "c:pathfile.txt"-17、Sub DecryptAndSendBinary (Path As

11、String, IncludeContentType As Boolean, ContentType As String, Key As CryptoKey, RemoveExt As Boolean, Optional Attachment, Optional FileName和SendBinary相同,但是发送之前会使用Key对文件进行编码,这个Key可以由AspEncrypt 组件生成。RemoveExt参数指定下载框中是否显示文件的扩展名。如果Attachment参数设置为True,输出的Header中Content-Disposition 将包括关键字"attachment

12、;",以强迫IE下载这个文件。FileName参数,指定下载框中显示的文件名。用法:"application/octet-stream", Key, True, True-18、Sub DeleteFile (Path As String删除文件。用法:Upload.DeleteFile "c:pathfile.txt"-19、FileExists (Path As String As Boolean检测文件是否存在。用法:if Upload.FileExists("c:pathfile.txt" Then .-20、Sub

13、 FromDatabase (Connect As String, SQL As String, Path As String使用ODBC,从数据库的表中输出BLOB字段到硬盘。Connect 指定ODBC连接字符串。SQL 该SQL语句应该返回一条记录,这个记录应该包括Blob字段。Path 完整的文件路径,包括文件名。用法:Upload.FromDatabase "DSN=mydb;UID=sa;PWD=xxx;", "select image_blob from myimages where id = 3", "c:pathfile.tx

14、t"-21、Sub FromRecordset (Recorset As Variant, Path As String使用ADO Recordset 对象从数据库的表中输出BLOB字段。Recordset 是一个recordset字段,比如rs("image_blob".。Path完整的路径,包括文件名。用法:Set rs = Server.CreateObject("adodb.recordset"rs.Open "MYIMAGES", Connect, 2, 3Upload.FromRecordset rs("

15、;image_blob"., "c:pathfile.txt"-22、Sub LOGOnUser (Domain As String, Username As String, Password As String, Optional Flags扮演指定的用户帐号。如果Domain 是空的,那么本机将会验证这个密码。如果您当前的安全设置不允许你执行上传到远程机器或者其他操作,可以使用这个方法。Flags 可以是以下值: LOGON_INTERACTIVE (2, default, LOGON_NETWORK (3, LOGON_BATCH (4, and LOGON

16、_SERVICE (5。不推荐使用这个可选参数。用法:Upload.LogonUser "domain", "jsmith", "xxxxxx"-23、Sub MoveFile (FromPath As String, ToPath As String移动文件。如果目标路径存在,这个方法将会报错。用法:Upload.MoveFile "c:path1file.ext", "c:path2file.ext"-24、OpenFile (Path As String As Object建立一个Uplo

17、adedFile 实例,它指向指定的文件。如果你想使用UploadedFile.Binary属性的优势,保存任意文件到数据库,这个方法很有用。用法:Set File = Upload.OpenFile("c:path1file.ext"-25、Sub RegisterServer (Path As String, Optional Register模仿 REGSVR32 (/u的动作。注册或者卸载指定的ActiveX DLL.如果Register参数为True或忽略,为注册DLL, 否则为卸载。用法:Upload.RegisterServer "c:path1fi

18、le.dll"Upload.RegisterServer "c:path1file.ocx", False-26、Sub RemoveDirectory (Path As String删除目录,如果目录包含文件或子目录,会报错。用法:Upload.RemoveDirectory "c:path"-27、Sub RevertToSelf结束由 LogonUser方法开始的扮演。通常不需要调用这个方法,角色扮演会自动结束。用法:Upload.RevertToSelf-28、Save (Optional Path, Optional Key, Opt

19、ional Ext As Long最主要的方法。捕获文件,保存到硬盘或内存,组装Files和Form集合。Path参数,如果指定,则是文件保存到的路径。如果Path参数被忽略,文件保存到内存,可以通过File.Binary存取,或者通过File.SaveAs 保存到硬盘。参数Key和Ext,用来加密上传的文件。Key是一个CryptoKey对象,它由ASPEncrypt组件生成。如果指定这个参数,文件保存之前将会被加密。Ext是可选扩展名。方法返回值:成功保存的文件数。用法:Count = Upload.Save save to memoryCount = Upload.Save("

20、c:upload" save to hard driveUpload.Save "c:upload" save to hard drive, ignore returnUpload.Save , Key, "xxx" Save to memory, encrypt with KeyUpload.Save "c:upload", Key, "xxx" Save to hard drive, encrypt with Key-29、SaveVirtual (Optional VirtualPath, Opti

21、onal Key, Optional Ext As Long和Save方法相同,但是参数为虚拟路径,而不是物理路径。方法内部调用Server.MapPath方法转换虚拟路径为物理路径。因此, Upload.SaveVirtual(path 等价于Upload.Save(Server.MapPath(path。在Web主机环境里,系统管理员可以禁止Save方法,强迫ASPUpload用户使用SaveVirtual 方法,以便限制他在自己的目录中进行操作。用法:Upload.SaveVirtual "/images"Upload.SaveVirtual "/image

22、s", Key, "xxx"-30、Sub SendBinary (Path As String, Optional IncludeContentType, Optional ContentType, Optional Attachment, Optional FileName用作文件下载。取得指定的文件,发送给客户端浏览器。参数IncludeContentType默认为True。它控制着是否建立Content-Type, Content-Disposition 和Content-Length 这些Header 信息. 如果设置为False,这些Header信息不

23、会建立。ContentType 指定Content-Type header。Attachment 默认为False。如果设置为True,“Content-Disposition” header 将包括“attachment”关键字,强迫浏览器弹出下载框,而不是在浏览器中打开。FileName 指定下载框中的文件名。用法:Upload.SendBinary "c:pathfile.ext", True, "application/octet-stream", True-31、Sub SetMaxSize (MaxSize As Long, Optional

24、 Reject指定单个文件的限定大小。参数Reject 指定过大的文件是否会拒绝(True的时候或截取(False或省略的时候。用法:Upload.SetMaxSize 150000, True-32、Sub ToDatabaseEx (Path As String, Connect As String, SQL As String, Optional MSAccessHeaders保存任意的文件到数据库。查看UploadedFile.ToDatabase 方法。用法:Upload.ToDatabaseEx "c:pathfile.txt", "DSN=mydb;

25、", "insert into myimages(image_blob s(?"-UploadedFile 属性=33、Attributes As Long (Read/Write设置和取得文件的系统属性。FILE_ATTR_READONLY = &H1FILE_ATTR_HIDDEN = &H2FILE_ATTR_SYSTEM = &H4FILE_ATTR_DirectorY = &H10FILE_ATTR_ARCHIVE = &H20FILE_ATTR_NORMAL = &H80FILE_ATTR_TEMPORA

26、RY = &H100FILE_ATTR_COMPRESSED = &H800用法:Response.Write File.AttributesFile.Attributes = File.Attributes + FILE_ATTR_READONLY-34、Binary As Variant (Read-Only返回文件的binary image 。It is a Variant-packed safe array of bytes.保存文件到数据库的时候有用。用法:rs.AddNewrs("image_blob. = File.Binaryrs.Update-35、

27、ContentType As String (Read-Only返回文件的Content-Type。如:"text/plain" 或 "application/octet-binary".用法:Response.Write File.ContentType-36、CreationTime As Date (Read-Only返回文件的创立时间戳。如果是内存文件,这个属性没有定义。用法:Response.Write File.CreationTime-37、Ext As String (Read-Only返回文件扩展名。用法:Response.Write File.Ext-38、FileName As String (Read-Only如果Upload.OverwriteFiles为False,它可能和原始文件名不同。用法:Response.Write File.FileName-39、Folder As String (Read-Only返回文件被保存的文件夹名。如果是内存文件,和原始文件夹名相同。用法:Response.Write File.Folde