w3 Image 2
Contents
1. The most obvious usage is for saving an uploaded file on the server and thus applying the method on a field of FILE type Example In the receiving code for a HTTP form the following saves a file submitted in the field named theFile a reference to a field object is created file upLoad Form theFile file SaveToFile D uploadSite uploadedFiles uploadedfile txt the field the file is saved on the server in the catalog D uploadsite uploadedFiles with the name uploadedfile txt ContentType Signature ContentType String Description Returns the contentType of the uploaded file Only works on file fields Example var fileField upLoad Form theFile var type new String fileField ContentType type now contains the content type of the file for example image pjpeg http www dimac net 11 w3 Upload 2 0 Manual FileName Signature FileName String Description The name of the originally uploaded file Example var fileField upLoad Form theFile var fileName new String fileField FileName fileName contains the name of original file including full path as found on the computer For example D pictures mypicture jpg IsFile Signature IsFile Boolean Description Returns true if the field is a File Example var fileField upLoad Form theFile var isFile new Boolean fileField IsFile2. isFile is true when the field is of file type Item Signature Item String Description Value of this field Returns the string if it is a textfield and so on Example var fileName upLoad Form theFileName var value new String fileField FileName value now contains the name the input field theFileName is of text type Name Signature Name String Description Returns the name of the inputfield as specified in the HTML of the submitting formpage http www dimac net 12 w3 Upload 2 0 Manual Example var fileField upLoad Form Items 1 var fieldName new String fileField Name fieldName now contains the name of the field in this case theFile Size Signature Size Integer Description Returns the size of the field file Example var fileField upLoad Form theFile var fileSize new Number fileField Size fileSize now contains the size of the file Count Signature Count Integer Description Returns the number of fields which share the same name in the collection Example var fileField upLoad Form theFile var fileCount new Number fileField Count fileCount is the number of fields with the name theFile Field Signature Field index w3 FormField Description Returns the w3 FormField in the collection identified by the numeric index When multiple fields with the same name exists the collection acces
3. name the user wishes of type text which is default and not explicitly declared in the INPUT tag 2 A field for the file where the user specifies the search path to the file either by keyboard entry or using the standard windows file browse dialog As stated previously the client must be using a browser that supports the INPUT tag of FILE type IIS 6 0 upload and download issues If you are having issues with uploads and downloads with file sizes greater than 200K and are running IIS 6 0 try these solutions first open up the file metabase xml with Notepad It should be located in C windows system32 inetserv Find the variable named AspMaxRequestEntity Allowed By default it is set at 204800 bytes 200 Kb change it to the desired size For downloading Find the variable named AspBufferingLimit and http www dimac net 6 w3 Upload 2 0 Manual change it to the desired value By default this is set to 4 MB By changing this variable you are increasing the max size of ASP response buffer thus letting you download files greater than 4 MB By increasing the number of these variables you can control the size of uploads and downloads respectively A NOTE Before making changes to this file you must first go to IIS and right click the server and select properties Check the box that says allow changes to MetaBase configuration while IIS is running If you don t you will find that the metabase xml file is l
4. a variable reference to a field object of the submitted field collection See also the Form member of the w3 upload object Example var firstField upLoad Form Items 0 firstField now contains the first field object of the submitted form For each fItem in upload Form loop the form using for each Response write fltem amp upload Form fItem next W3 FormField IsEmpty Signature IsEmpty Boolean Description Returns true if the field is empty Note Not yet implemented SaveAsUniqueFile Signature SaveAsUniqueFile bstrFileName String Description Saves the file as a Unique file and returns the new name Adds a numbering at the end of the given filename http www dimac net 10 w3 Upload 2 0 Manual Same as SaveToFile except for this numbering feature Example In the receiving code for a HTTP form the following saves a file submitted in the field named theFile a reference to a field object is created file upLoad Form theFile Var theName file SaveAsUniqueFile D uploadSite uploadedfile txt the field the file is saved on the server in the catalog D uploadsite with the name uploadedfile txt or uploadedfile 1 txt if it already exists or uploadedfile 2 txt and so on it returns the name into variable theName ee aS as ke as N SaveToFile Signature SaveToFile bstrFileName Description Saves the field to disk
5. aded files can be directed and named by the user who w3 Upload allows you to mix standard forms with the upload form thus making it possible for you to seamlessly integrate w3 Upload into your forms It also provides the possibility to create and extract content from ZIP files http www dimac net 5 w3 Upload 2 0 Manual Getting Started Uploading to a server w3 Upload works exactly as the usual HTTP form object and the file is accessed from the server for storage or manipulation as any other field text for example To utilize this architecture you need two pieces of code The form where the client specifies and submits the file and receiving code which saves the file on the server or generates any other response The following is an example of a very simple form that could be used lt LANGUAGE AVASCRI PT gt lt HTML gt lt HEAD gt lt TITLE gt Upload Form lt TITLE gt lt HEAD gt lt BODY gt lt Hl gt Load Form lt H1 gt lt FORM ACTI ON loadit asp METHOD POST ENCTYPE multipart form data gt Name lt BR gt lt INPUT NAME fileName gt lt BR gt File lt BR gt lt INPUT NAME theFile TYPE File gt lt BR gt lt INPUT TYPE Submit VALUE Send gt lt BR gt lt FORM gt lt BODY gt lt HTML gt Things to note The ENCTYPE parameter of the FORM tag Has to be set to mul tipart form data as specified There are two fields submitted 1 A field for specifying the
6. e item Example arch Open c files zipfile zip for var i 0 i lt arch Count i Response Write arch Item i Name lt br gt Response Write arch Item i Size IsFolder Signature IsFolder Bool Description Returns whether the item is a folder Example arch Open c files zipfile zip for var i 0 i lt arch Count i Response Write arch Item i isFolder lt br gt Size Signature Size Long Description Returns the uncompressed size of the item Example arch Open c files zipfile zip for var i 0 i lt arch Count i Response Write item Size lt br gt ModifiedDate Signature ModifiedDate Date Description Returns the modified date of the item Example arch Open c files zipfile zip for var i 0 i lt arch Count i Response Write item ModifiedDate lt br gt http www dimac net 16 w3 Upload 2 0 Manual W3 Progress ProgressID Signature ProgressID String Description Returns a unique identifier used to identify an upload process Example Response Write progress ProgressID GUID Signature GUID String Description Returns a GUID Example Response Write progress GUID http www dimac net 17
7. nevacedssaguessansdssoetan 15 Nadia iii 16 ISEOlder eaten aaa adn ist anota 16 ad abs 16 ModiticdDiteiaiin aaa an 16 http www dimac net 2 w3 Upload 2 0 Manual http www dimac net w3 Upload 2 0 Manual Copyright We have done our best to ensure that the information in this manual is both accurate and useful however please be aware that errors may exist and that Dimac Development Duplo AB hereafter referred to as Duplo does not give any guarantees concerning the accuracy of the information here or in the use to which it may be put Duplo may have patents and or pending patent applications covering subject matter in this document Copyright O 2004 Duplo AB All rights reserved This document may only be reproduced in whole or part copied photocopied translated or converted to any electronic or machine readable form with the prior permission of Duplo Dimac Development Phone 46 42 35 94 00 Duplo AB Fax 46 42 15 80 50 Pr stgatan 12 Homepage http www dimac net E mail info dimac net ad Support support dimac net Sweden If any problems occur using this application please visit our web site http www dimac net http www dimac net 4 w3 Upload 2 0 Manual Introduction w3 Upload makes it possible for you to upload multiple files using simple ASP and HTML coding technologies and to control the maximum file size or to limit the content type of the uploaded files The placement of uplo
8. ocked For good house cleaning you should go back and uncheck this after making your changes http www dimac net 7 w3 Upload 2 0 Manual Object Model W3 Upload GetData Signature GetData String Description Returns ALL mimedata as a string SendFile Signature SendFile bstrFileName bSetContentTypel Description Sends a local file on the server to the client The method takes two arguments path of the file to be sent and a content type Instead of explicitly setting the content type you can set the second parameter to true and leave it up to upLoad which is probably the best way to do it Please see the Getting Started chapter for usage information Example upLoad SendFile D upload test jpg true will send the specified file on the server to the client browser where it will most likely be displayed Form Signature Form w3 FieldCollection Description Replacement Form object Use this as the normal form object See also the Getting Started chapter There are several uses as this enables access to the field collection of the submitted form Perhaps is the creation of references to indivdual field objects of the collection the most common usage You can either reference the field by it s name by using a numeric index or by enumeration for each See the reference of your chosen development envirnoment on handling of collections for further information h
9. scription Extracts a file from the archive Note the archive must be open http www dimac net 14 w3 Upload 2 0 Manual Example arch Open c files zipfile zip arch ExtractFile w00t jpg c files AddFile Signature AddFile fileName String Description Adds a file to the archive Note the archive must be open Example arch Open c files zipfile zip arch AddFile c files ls txt AddFiles Signature AddFiles path String recurse Bool Description Adds a directory to the archive Note the archive must be open Example arch Open c files zipfile zip arch AddFiles c files true FindFile Signature FindFile fileName String Bool Description Returns true if fileName could be found in the archive Note the archive must be open Example arch Open c files zipfile zip arch FindFile w00t jpg Count Signature Count Long Description Returns the number of items in the zipfile Example arch Open c files zipfile zip Response Write arch Count W3 Archiveltem Name Signature Name String Description http www dimac net 15 w3 Upload 2 0 Manual Returns the name of the item Example arch Open c files zipfile zip for var i 0 i lt arch Count i Response Write arch Item i Name lt br gt Response Write arch Item i Size Name Signature Name String Description Returns the name of th
10. sed by this property contains all the relevant w3 FormField objects The first index O item actually represents the current object used Example var fileFields upLoad Form theFile var 1 for 0 i lt fileFields Count I f fileFields Field I f SaveAsUniqueFile upload txt http www dimac net 13 w3 Upload 2 0 Manual BinaryData Signature BinaryData Byte Description Returns a file as a byte array useful when adding the file to a database Example rs Server CreateObject ADODB Recordset rs Open SELECT FROM blobtest WHERE id 42 conn adOpenDynamic adLockOptimistic rs blob AppendChunk upload Form theFile BinaryData rs Update W3 Archive Create Signature Create fileName String Description Creates a new archive with the specified file name Example archive Create c files zipfile zip Open Signature Open FileName String password String Bool Description Returns a file as a byte array useful when adding the file to a database Example arch Open c files zipfile zip s3cr3t Extract Signature Extract zipFile String destinationDir String fileMask String pathType Long Description Extract the files from the archive Example arch Extract c files file zip c newfiles arch RELATIVE PATH ExtractFile Signature ExtractFile fileName String destination String De
11. ttp www dimac net 8 w3 Upload 2 0 Manual Example creating a variable reference to an individual field object in the field collection of the submitted form var aName upLoad Form chosenFileName var uploadedFile upLoad Form theFile you can type cast the variables if you wish for readability reasons although it is usually an unecessary encapsulation of the object thus alternatively you could write var aName new String upLoad Form chosenFileName ProgressParts Signature ProgressParts Long Description Specifies how many intervals the progressbar should use See W3 Progressbar for more information SendAdodbField Signature SendADODBField AdoDBField as Object Description Deprecated Please use FormField Binary Data in conjunction with a stream object See FormField BinaryData for more information W3 FieldCollection The FieldCollection refers to the form items in the posted form Count Signature Count Integer Description Returns the number of fields in the submitted form Useful if you wish to have a dynamic number of fields submitted http www dimac net 9 w3 Upload 2 0 Manual Example var noOfFields new Number upLoad Form Count noOfFields contains the number of fields in the submitted form ltems Signature Items index w3 FormField Description Returns the field object This is the second way to create
12. w3 Upload 2 0 Manual w3 Upload 2 0 User Manual 57 http www dimac net 1 w3 Upload 2 0 Manual Contents Contents ida 2 a o A UE JE EE A A E 4 Dali o 64 64H O e AAE AR SD AO RS ceeinene 5 Getting ad 6 Uploading toa SEL VOU ci ii id 6 IIS 6 0 upload and download SUS a 6 A e RR RR ea a E EE 8 Jn eesi e ED ei ERP O O ED RR 8 GetDafa DARREN PROA ER ad RSS 8 Send Ple manita 8 FO eer n a a e RIO OS JR A EEE EE AN 8 PIS ad 9 SENGAGOGD ii iia 9 W3 FieldCollectiON isa ii idas a id diia 9 COUN RR ss po ces DD Sas sees sans ROAD Send Gs og PDDE SRT ea 9 SMS guaritas TNT 10 W3 FormBield iii ii ssa ava adiar eta vets odode SPEA aid asad dia ii 10 A a RR EEE GORDA RR POR 10 nave as Unique Ple ii a a 10 aveo Fleitas atad 11 COn Pa 11 Bale N ME iii A A AAA AAA AA AAA E da 12 WSU E E E EEE EE A ERROR ada Pa ORAR E Up 12 O EEE EAE E AEE E A O RAN 12 Naerenn a a E E A A S 12 SO sete O 13 COUT arnee a aa ea a a a e a E 13 Field iee A E E E E S 13 Binary Data AA Ann E RR a ETE 14 W3I ATCO VE di 14 Create Re ee Eee ee 14 Ajo RSRSRS o CR SUR enter A ener ar Ce RR 14 Extracine aa LA SARA dao ea Da 14 EXxtractBile vit RR 14 AO DG an adi 15 A DER vatadeae ini a RR RD DER Aa PRE DRDS ERREI POD RE o PNI SD 15 PUTED Coina ANE RR OD CRER AU CURE RREO RS DE CARR E RO ORE e 15 COM dt 15 SN A tis rena cando a feia sf sd do dl o NA q Dida EaD 15 NAME cc csscisnisasdtvveccdacewnesberavacedaunseeds sired edesaneasbeasvacctvaSeeuni evacadedaerasta
Download Pdf Manuals
Related Search