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

1、AspUpload的屬性及其使用方法詳細(xì)介紹1、CodePage As Long (Read/Write可以把表單的文本項(xiàng)目名和文件名的字符從指定的 CodePage轉(zhuǎn)換為Unicode,比如表單是按UTF-8提交的,那么這個(gè)屬性應(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)為T(mén)rue。這個(gè)屬性用來(lái)控制是否檢測(cè)上傳的文件是MacBinary格式的,如果是則從中提取“data fork”。AspUpload 3.0 Beta 1. 不支持。用法:Upload.DetectMacBinary = False-3、Directory (Path As String, Optional SortBy, Optional Ascending As Object (Read-Only返回一個(gè)集合,這個(gè)集合包括指定目錄的所有子目錄和文件的引用。在這個(gè)集合里,子目錄總是優(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)為T(mén)rue。用法:Set Dir = Upload.Directory("c:path*.*", SORTBY_SIZEFor Each Item in Dir.Next-4、Expires As Date (Read-Only如果已經(jīng)注冊(cè),返回9/9/9999,否則返回失效期。用法:R

4、esponse.Write Upload.Expires-5、Files As Object (Read-Only返回一個(gè)集合,這個(gè)集合包含有上傳文件的引用。使用這個(gè)集合之前,必須調(diào)用Save或 SaveVirtual方法。要引用一個(gè)單個(gè)文件,可以使用從1開(kāi)始的整數(shù)下標(biāo),或者相應(yīng)的文件框的名稱(chēng)。要列舉集合里的項(xiàng)目,可以使用For/Each 語(yǔ)句。用法:Set File = Upload.Files(1Set File = Upload.Files("FILE1"For Each File in Upload.Files.Next-6、Form As Object (Read

5、-Only返回一個(gè)集合,這個(gè)集合包括所有不是文件框的表單項(xiàng)目的引用。使用這個(gè)集合之前,必須調(diào)用Save或 SaveVirtual方法。要引用一個(gè)單個(gè)表單項(xiàng)目,可以使用從1開(kāi)始的整數(shù)下標(biāo),或者相應(yīng)的項(xiàng)目的名稱(chēng)。要列舉集合里的項(xiàng)目,可以使用For/Each 語(yǔ)句。用法: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、而不是通過(guò)表單提交時(shí),可以避免 "Wrong Content-Type"這個(gè)錯(cuò)誤。當(dāng)表單和相應(yīng)的上傳腳本在同一個(gè)文件時(shí),這個(gè)屬性很有用。用法:Upload.IgnoreNoPost = True-8、OverwriteFiles As Boolean (Read/Write默認(rèn)為T(mén)rue。如果設(shè)置為False,那么當(dāng)文件名已經(jīng)存在時(shí),AspUpload會(huì)在原文件名后附加“(12”這種形式的字符。這個(gè)屬性影響Save, SaveVirtual 和 File.SaveAs方法。用法:Upload.OverwriteFiles = False-9、PreserveFileTime

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

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

10、teDirectory (Path As String, Optional IgnoreAlreadyExists建立目錄。IgnoreAlreadyExists 默認(rèn)為False。如果設(shè)置為T(mén)rue,當(dāng)目標(biāo)路徑存在時(shí),這個(gè)方法不會(huì)報(bào)錯(cuò)。用法:Upload.CreateDirectory "c:dir1dir2", True-17、Sub CreateFile (Path As String建立一個(gè)空文件。用法: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ā)送之前會(huì)使用Key對(duì)文件進(jìn)行編碼,這個(gè)Key可以由AspEncrypt 組件生成。RemoveExt參數(shù)指定下載框中是否顯示文件的擴(kuò)展名。如果Attachment參數(shù)設(shè)置為T(mén)rue,輸出的Header中Content-Disposition 將包括關(guān)鍵字"attachment

12、;",以強(qiáng)迫IE下載這個(gè)文件。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檢測(cè)文件是否存在。用法:if Upload.FileExists("c:pathfile.txt" Then .-20、Sub

13、 FromDatabase (Connect As String, SQL As String, Path As String使用ODBC,從數(shù)據(jù)庫(kù)的表中輸出BLOB字段到硬盤(pán)。Connect 指定ODBC連接字符串。SQL 該SQL語(yǔ)句應(yīng)該返回一條記錄,這個(gè)記錄應(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 對(duì)象從數(shù)據(jù)庫(kù)的表中輸出BLOB字段。Recordset 是一個(gè)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扮演指定的用戶帳號(hào)。如果Domain 是空的,那么本機(jī)將會(huì)驗(yàn)證這個(gè)密碼。如果您當(dāng)前的安全設(shè)置不允許你執(zhí)行上傳到遠(yuǎn)程機(jī)器或者其他操作,可以使用這個(gè)方法。Flags 可以是以下值: LOGON_INTERACTIVE (2, default, LOGON_NETWORK (3, LOGON_BATCH (4, and LOGON

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

17、adedFile 實(shí)例,它指向指定的文件。如果你想使用UploadedFile.Binary屬性的優(yōu)勢(shì),保存任意文件到數(shù)據(jù)庫(kù),這個(gè)方法很有用。用法:Set File = Upload.OpenFile("c:path1file.ext"-25、Sub RegisterServer (Path As String, Optional Register模仿 REGSVR32 (/u的動(dòng)作。注冊(cè)或者卸載指定的ActiveX DLL.如果Register參數(shù)為T(mén)rue或忽略,為注冊(cè)DLL, 否則為卸載。用法:Upload.RegisterServer "c:path1fi

18、le.dll"Upload.RegisterServer "c:path1file.ocx", False-26、Sub RemoveDirectory (Path As String刪除目錄,如果目錄包含文件或子目錄,會(huì)報(bào)錯(cuò)。用法:Upload.RemoveDirectory "c:path"-27、Sub RevertToSelf結(jié)束由 LogonUser方法開(kāi)始的扮演。通常不需要調(diào)用這個(gè)方法,角色扮演會(huì)自動(dòng)結(jié)束。用法:Upload.RevertToSelf-28、Save (Optional Path, Optional Key, Opt

19、ional Ext As Long最主要的方法。捕獲文件,保存到硬盤(pán)或內(nèi)存,組裝Files和Form集合。Path參數(shù),如果指定,則是文件保存到的路徑。如果Path參數(shù)被忽略,文件保存到內(nèi)存,可以通過(guò)File.Binary存取,或者通過(guò)File.SaveAs 保存到硬盤(pán)。參數(shù)Key和Ext,用來(lái)加密上傳的文件。Key是一個(gè)CryptoKey對(duì)象,它由ASPEncrypt組件生成。如果指定這個(gè)參數(shù),文件保存之前將會(huì)被加密。Ext是可選擴(kuò)展名。方法返回值:成功保存的文件數(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 等價(jià)于Upload.Save(Server.MapPath(path。在Web主機(jī)環(huán)境里,系統(tǒng)管理員可以禁止Save方法,強(qiáng)迫ASPUpload用戶使用SaveVirtual 方法,以便限制他在自己的目錄中進(jìn)行操作。用法: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)為T(mén)rue。它控制著是否建立Content-Type, Content-Disposition 和Content-Length 這些Header 信息. 如果設(shè)置為False,這些Header信息不

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

24、 Reject指定單個(gè)文件的限定大小。參數(shù)Reject 指定過(guò)大的文件是否會(huì)拒絕(True的時(shí)候或截取(False或省略的時(shí)候。用法:Upload.SetMaxSize 150000, True-32、Sub ToDatabaseEx (Path As String, Connect As String, SQL As String, Optional MSAccessHeaders保存任意的文件到數(shù)據(jù)庫(kù)。查看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ù)庫(kù)的時(shí)候有用。用法: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)立時(shí)間戳。如果是內(nèi)存文件,這個(gè)屬性沒(méi)有定義。用法:Response.Write File.CreationTime-37、Ext As String (Read-Only返回文件擴(kuò)展名。用法: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