AspUpload的屬性及其使用方法詳細(xì)介紹

1、AspUpload的屬性及其使用方法詳細(xì)介紹1、CodePage As Long (Read/Write可以把表單的文本項目名和文件名的字符從指定的 CodePage轉(zhuǎn)換為Unicode,比如表單是按UTF-8提交的,那么這個屬性應(yīng)該設(shè)置為65001。其他的如 51 (Cyrillic, 1255 (Hebrew, 1256 (Arabic等等。用法:< type=text/Java>attachEvent("", (AutoSizeDIV(CODE_7643 程序代碼: Upload.CodePage = 65001-2、DetectMacBinary As

2、Boolean (Read/Write默認(rèn)為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返回一個集合,這個集合包括指定目錄的所有子目錄和文件的引用。在這個集合里,子目錄總是優(yōu)先于文件.Path 可以包括通配符 * 和 ?。SortBy 可以是

3、: SORTBY_NAME (1, default. SORTBY_TYPE (2, SORTBY_SIZE (3, SORTBY_CREATIONTIME(4,SORTBY_LASTWRITETIME(5,and SORTBY_LASTAccessTIME (6. Ascending 默認(rèn)為True。用法:Set Dir = Upload.Directory("c:path*.*", SORTBY_SIZEFor Each Item in Dir.Next-4、Expires As Date (Read-Only如果已經(jīng)注冊,返回9/9/9999,否則返回失效期。用法:R

4、esponse.Write Upload.Expires-5、Files As Object (Read-Only返回一個集合,這個集合包含有上傳文件的引用。使用這個集合之前,必須調(diào)用Save或 SaveVirtual方法。要引用一個單個文件,可以使用從1開始的整數(shù)下標(biāo),或者相應(yīng)的文件框的名稱。要列舉集合里的項目,可以使用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返回一個集合,這個集合包括所有不是文件框的表單項目的引用。使用這個集合之前,必須調(diào)用Save或 SaveVirtual方法。要引用一個單個表單項目,可以使用從1開始的整數(shù)下標(biāo),或者相應(yīng)的項目的名稱。要列舉集合里的項目,可以使用For/Each 語句。用法:Name = Upload.Form(1Name = Upload.Form("Name"For Each Item in Upload.FormResponse.Write Item.Next-7、IgnoreNoPost As Boolean (Read/Write當(dāng)Upload.Save方法被腳本直接調(diào)用,

6、而不是通過表單提交時,可以避免 "Wrong Content-Type"這個錯誤。當(dāng)表單和相應(yīng)的上傳腳本在同一個文件時,這個屬性很有用。用法:Upload.IgnoreNoPost = True-8、OverwriteFiles As Boolean (Read/Write默認(rèn)為True。如果設(shè)置為False,那么當(dāng)文件名已經(jīng)存在時,AspUpload會在原文件名后附加“(12”這種形式的字符。這個屬性影響Save, SaveVirtual 和 File.SaveAs方法。用法:Upload.OverwriteFiles = False-9、PreserveFileTime

7、 As Boolean (Read/Write默認(rèn)為Flase。如果設(shè)置為True,會試圖保護上傳文件的上次修改時間。這個屬性只是客戶端使用XUpload或者JUpload 的時候有用。當(dāng)使用常規(guī)Form提交的時候,它沒有任何作用。用法:Upload.PreserveFileTime = False-10、ProgressID As String (Read/Write上傳進度條所用的,用來區(qū)分上傳進程。用法:Upload.ProgressID = Request.QueryString("PID"-11、RegKey As String (Read/Write指定注冊碼,

8、如果沒有指定,AspUpload會從系統(tǒng)注冊表讀取。用法:Upload.RegKey = "12345-67890-12345"-12、TotalBytes As Long (Read-Only返回上傳的總字節(jié)數(shù)。只能在成功調(diào)用Save(SaveVirtual方法后調(diào)用這個屬性。用法:Response.Write Upload.TotalBytes-13、TotalSeconds As Long (Read-Only返回上傳持續(xù)的總時間。只能在成功調(diào)用Save(SaveVirtual方法后調(diào)用這個屬性。用法: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 復(fù)制文件。Overwrite 默認(rèn)為True。如果設(shè)置為False,當(dāng)目標(biāo)路徑存在時,這個方法會失敗。用法:Upload.CopyFile "c:path1file.ext", "c:path2file.ext"-16、Sub Crea

10、teDirectory (Path As String, Optional IgnoreAlreadyExists建立目錄。IgnoreAlreadyExists 默認(rèn)為False。如果設(shè)置為True,當(dāng)目標(biāo)路徑存在時,這個方法不會報錯。用法: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相同,但是發(fā)送之前會使用Key對文件進行編碼,這個Key可以由AspEncrypt 組件生成。RemoveExt參數(shù)指定下載框中是否顯示文件的擴展名。如果Attachment參數(shù)設(shè)置為True,輸出的Header中Content-Disposition 將包括關(guān)鍵字"attachment

12、;",以強迫IE下載這個文件。FileName參數(shù),指定下載框中顯示的文件名。用法:"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,從數(shù)據(jù)庫的表中輸出BLOB字段到硬盤。Connect 指定ODBC連接字符串。SQL 該SQL語句應(yīng)該返回一條記錄,這個記錄應(yīng)該包括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 對象從數(shù)據(jù)庫的表中輸出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 是空的,那么本機將會驗證這個密碼。如果您當(dāng)前的安全設(shè)置不允許你執(zhí)行上傳到遠(yuǎn)程機器或者其他操作,可以使用這個方法。Flags 可以是以下值: LOGON_INTERACTIVE (2, default, LOGON_NETWORK (3, LOGON_BATCH (4, and LOGON

16、_SERVICE (5。不推薦使用這個可選參數(shù)。用法:Upload.LogonUser "domain", "jsmith", "xxxxxx"-23、Sub MoveFile (FromPath As String, ToPath As String移動文件。如果目標(biāo)路徑存在,這個方法將會報錯。用法:Upload.MoveFile "c:path1file.ext", "c:path2file.ext"-24、OpenFile (Path As String As Object建立一個Uplo

17、adedFile 實例,它指向指定的文件。如果你想使用UploadedFile.Binary屬性的優(yōu)勢,保存任意文件到數(shù)據(jù)庫,這個方法很有用。用法:Set File = Upload.OpenFile("c:path1file.ext"-25、Sub RegisterServer (Path As String, Optional Register模仿 REGSVR32 (/u的動作。注冊或者卸載指定的ActiveX DLL.如果Register參數(shù)為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結(jié)束由 LogonUser方法開始的扮演。通常不需要調(diào)用這個方法,角色扮演會自動結(jié)束。用法:Upload.RevertToSelf-28、Save (Optional Path, Optional Key, Opt

19、ional Ext As Long最主要的方法。捕獲文件,保存到硬盤或內(nèi)存,組裝Files和Form集合。Path參數(shù),如果指定,則是文件保存到的路徑。如果Path參數(shù)被忽略,文件保存到內(nèi)存,可以通過File.Binary存取,或者通過File.SaveAs 保存到硬盤。參數(shù)Key和Ext,用來加密上傳的文件。Key是一個CryptoKey對象,它由ASPEncrypt組件生成。如果指定這個參數(shù),文件保存之前將會被加密。Ext是可選擴展名。方法返回值:成功保存的文件數(shù)。用法: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方法相同,但是參數(shù)為虛擬路徑,而不是物理路徑。方法內(nèi)部調(diào)用Server.MapPath方法轉(zhuǎn)換虛擬路徑為物理路徑。因此, Upload.SaveVirtual(path 等價于Upload.Save(Server.MapPath(path。在Web主機環(huán)境里,系統(tǒng)管理員可以禁止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用作文件下載。取得指定的文件,發(fā)送給客戶端瀏覽器。參數(shù)IncludeContentType默認(rèn)為True。它控制著是否建立Content-Type, Content-Disposition 和Content-Length 這些Header 信息. 如果設(shè)置為False,這些Header信息不

23、會建立。ContentType 指定Content-Type header。Attachment 默認(rèn)為False。如果設(shè)置為True,“Content-Disposition” header 將包括“attachment”關(guān)鍵字,強迫瀏覽器彈出下載框,而不是在瀏覽器中打開。FileName 指定下載框中的文件名。用法:Upload.SendBinary "c:pathfile.ext", True, "application/octet-stream", True-31、Sub SetMaxSize (MaxSize As Long, Optional

24、 Reject指定單個文件的限定大小。參數(shù)Reject 指定過大的文件是否會拒絕(True的時候或截取(False或省略的時候。用法:Upload.SetMaxSize 150000, True-32、Sub ToDatabaseEx (Path As String, Connect As String, SQL As String, Optional MSAccessHeaders保存任意的文件到數(shù)據(jù)庫。查看UploadedFile.ToDatabase 方法。用法:Upload.ToDatabaseEx "c:pathfile.txt", "DSN=mydb;

25、", "insert into myimages(image_blob s(?"-UploadedFile 屬性=33、Attributes As Long (Read/Write設(shè)置和取得文件的系統(tǒng)屬性。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.保存文件到數(shù)據(jù)庫的時候有用。用法: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返回文件的創(chuàng)立時間戳。如果是內(nèi)存文件,這個屬性沒有定義。用法: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返回文件被保存的文件夾名。如果是內(nèi)存文件,和原始文件夾名相同。用法:Response.Write File.Folde