AspUpload组件的方法中文说明

CodePage As Long (Read/Write) 
可以把表单的文本项目名和文件名的字符从指定的CodePage转换为Unicode,比如表单是按UTF-8提交的,那么这个属性应该设置为65001。其他的如1251 (Cyrillic), 1255 (Hebrew), 1256 (Arabic)等等。 用法:

程序代码: [ 复制代码到剪贴板 ]
Upload.CodePage = 65001 

-------------------------------------------
DetectMacBinary As Boolean (Read/Write) 
默认为True。 这个属性用来控制是否检测上传的文件是MacBinary格式的,如果是则从中提取“data fork”。AspUpload 3.0 Beta 1. 不支持。 用法:
Upload.DetectMacBinary = False 
--------------------------------------------
Directory (Path As String, Optional SortBy, Optional Ascending) As Object (Read-Only) 
返回一个集合,这个集合包括指定目录的所有子目录和文件的引用。
在这个集合里,子目录总是优先于文件.Path 可以包括通配符 * 和 ?。 SortBy 可以是: SORTBY_NAME (1, default). SORTBY_TYPE (2), SORTBY_SIZE (3), SORTBY_CREATIONTIME (4), SORTBY_LASTWRITETIME (5), and SORTBY_LASTACCESSTIME (6).  Ascending 默认为True。 用法: <!--METADATA TYPE="TypeLib" UUID="{B4E1B2DE-151B-11D2-926A-006008123235}"-->
Set Dir = Upload.Directory("c:path*.*", SORTBY_SIZE)
For Each Item in Dir
...
Next
-------------------------------------------
Expires As Date (Read-Only) 
如果已经注册,返回9/9/9999,否则返回失效期。 用法:
Response.Write Upload.Expires 
-------------------------------------------
Files As Object (Read-Only) 
返回一个集合,这个集合包含有上传文件的引用。 使用这个集合之前,必须调用Save或 SaveVirtual方法。 要引用一个单个文件,可以使用从1开始的整数下标,或者相应的文件框的名称。 要列举集合里的项目,可以使用For/Each 语句。  用法: Set File = Upload.Files(1)  Set File = Upload.Files("FILE1")  For Each File in Upload.Files
...
Next
-------------------------------------------
Form As Object (Read-Only) 
返回一个集合,这个集合包括所有不是文件框的表单项目的引用。 使用这个集合之前,必须调用Save或 SaveVirtual方法。  要引用一个单个表单项目,可以使用从1开始的整数下标,或者相应的项目的名称。 要列举集合里的项目,可以使用For/Each 语句。  用法: Name = Upload.Form(1)  Name = Upload.Form("Name")  For Each Item in Upload.Form
   Response.Write Item.Value
Next
-------------------------------------------
IgnoreNoPost As Boolean (Read/Write) 
当Upload.Save方法被脚本直接调用,而不是通过表单提交时,可以避免 "Wrong Content-Type"这个错误。当表单和相应的上传脚本在同一个文件时,这个属性很有用。 用法: Upload.IgnoreNoPost = True 
-------------------------------------------
OverwriteFiles As Boolean (Read/Write) 
默认为True。如果设置为False,那么当文件名已经存在时,AspUpload会在原文件名后附加“(12)”这种形式的字符。这个属性影响Save, SaveVirtual 和 File.SaveAs方法。
用法: Upload.OverwriteFiles = False 
-------------------------------------------
PreserveFileTime As Boolean (Read/Write) 
默认为Flase。如果设置为True,会试图保护上传文件的上次修改时间。  
这个属性只是客户端使用XUpload或者JUpload 的时候有用。
当使用常规Form提交的时候,它没有任何作用。
用法: Upload.PreserveFileTime = False 
-------------------------------------------
ProgressID As String (Read/Write) 
上传进度条所用的,用来区分上传进程。 用法: Upload.ProgressID = Request.QueryString("PID") 
-------------------------------------------
RegKey As String (Read/Write) 
指定注册码,如果没有指定,AspUpload会从系统注册表读取。
用法: Upload.RegKey = "12345-67890-12345" 
-------------------------------------------
TotalBytes As Long (Read-Only) 
返回上传的总字节数。
只能在成功调用Save(SaveVirtual)方法后调用这个属性。  用法:
Response.Write Upload.TotalBytes 
-------------------------------------------
TotalSeconds As Long (Read-Only) 
返回上传持续的总时间。
只能在成功调用Save(SaveVirtual)方法后调用这个属性。 用法:
Response.Write Upload.TotalSeconds 
-------------------------------------------
Version As String (Read-Only) 
返回组件的版数,如:"3.0.0.0". 
用法: Response.Write Upload.Version 
-------------------------------------------
UploadManager Methods
======================================================
Sub CopyFile (FromPath As String, ToPath As String, Optional Overwrite) 
复制文件。
Overwrite 默认为True。如果设置为False,当目标路径存在时,这个方法会失败。 用法:
Upload.CopyFile "c:path1file.ext", "c:path2file.ext" 
-------------------------------------------
Sub CreateDirectory (Path As String, Optional IgnoreAlreadyExists) 
建立目录。
IgnoreAlreadyExists 默认为False。如果设置为True,当目标路径存在时,这个方法不会报错。 用法:
Upload.CreateDirectory "c:dir1dir2", True 
-------------------------------------------
Sub CreateFile (Path As String) 
建立一个空文件。 用法:
Upload.CreateFile "c:pathfile.txt"  ----------------- --------------------------
Sub DecryptAndSendBinary (Path As 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;",以强迫IE下载这个文件。  FileName参数, 指定下载框中显示的文件名。 用法:
Upload.DecryptAndSendBinary "c:dirfile.txt.xxx", True, "application/octet-stream", Key, True, True  -------------------------------------------
Sub DeleteFile (Path As String) 
删除文件。 用法:
Upload.DeleteFile "c:pathfile.txt" 
-------------------------------------------
Function FileExists (Path As String) As Boolean 
检测文件是否存在。 用法:
if Upload.FileExists("c:pathfile.txt") Then ... 
-------------------------------------------
Sub 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.txt" 
-------------------------------------------
Sub FromRecordset (RecorsetValue As Variant, Path As String) 使用ADO Recordset 对象从数据库的表中输出BLOB字段。 RecordsetValue 是一个recordset字段,比如rs("image_blob").Value。 Path 完整的路径,包括文件名。 用法:
Set rs = Server.CreateObject("adodb.recordset")
rs.Open "MYIMAGES", Connect, 2, 3
Upload.FromRecordset rs("image_blob").Value, "c:pathfile.txt" 
-------------------------------------------
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_SERVICE (5)。不推荐使用这个可选参数。
用法:
Upload.LogonUser "domain", "jsmith", "xxxxxx" 
-------------------------------------------
Sub MoveFile (FromPath As String, ToPath As String) 移动文件。如果目标路径存在,这个方法将会报错。 用法:
Upload.MoveFile "c:path1file.ext", "c:path2file.ext" 
-------------------------------------------
Function OpenFile (Path As String) As Object 建立一个UploadedFile 实例,它指向指定的文件。
如果你想使用UploadedFile.Binary属性的优势,保存任意文件到数据库,这个方法很有用。 用法:
Set File = Upload.OpenFile("c:path1file.ext") 
-------------------------------------------
Sub RegisterServer (Path As String, Optional Register) 模仿 REGSVR32 (/u)的动作。 注册或者卸载指定的ActiveX DLL.  如果Register参数为True或忽略,为注册DLL, 否则为卸载。 用法:
Upload.RegisterServer "c:path1file.dll" Upload.RegisterServer "c:path1file.ocx", False
-------------------------------------------
Sub RemoveDirectory (Path As String) 
删除目录,如果目录包含文件或子目录,会报错。 用法:
Upload.RemoveDirectory "c:path" 
-------------------------------------------
Sub RevertToSelf
结束由 LogonUser方法开始的扮演。
通常不需要调用这个方法,角色扮演会自动结束。 用法:
Upload.RevertToSelf 
-------------------------------------------
Function Save (Optional Path, Optional Key, Optional Ext) As Long 
最主要的方法。捕获文件,保存到硬盘或内存,组装Files和Form集合。 Path参数, 如果指定,则是文件保存到的路径。 如果Path参数被忽略,文件保存到内存,可以通过File.Binary存取,或者通过File.SaveAs保存到硬盘。 参数Key和Ext,用来加密上传的文件。 Key是一个CryptoKey对象,它由AspEncrypt组件生成。如果指定这个参数,文件保存之前将会被加密。 Ext是可选扩展名。 方法返回值:成功保存的文件数。 用法: Count = Upload.Save ' save to memory Count = Upload.Save("c:upload") ' save to hard drive Upload.Save "c:upload" ' save to hard drive, ignore return value Upload.Save , Key, "xxx" ' Save to memory, encrypt with Key Upload.Save "c:upload", Key, "xxx" ' Save to hard drive, encrypt with Key
-------------------------------------------
Function SaveEncrypted (Path As String, Key As Object, Ext As String) As Long 
此方法废止。 只用来向后兼容。用Save方法替代。 Upload.SaveEncrypted(Path, Key, Ext)
等价于
Upload.Save(Path, Key, Ext) 
-------------------------------------------
Function SaveToMemory As Long 
此方法废止。 只用来向后兼容。用Save方法替代。 Upload.SaveToMemory
等价于
Upload.Save 
-------------------------------------------
Function SaveVirtual (Optional VirtualPath, Optional Key, Optional Ext) As Long  和Save方法相同,但是参数为虚拟路径,而不是物理路径。  方法内部调用Server.MapPath方法转换虚拟路径为物理] ]>

发表评论

电子邮件地址不会被公开。 必填项已用*标注