ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
When all of the data loads from the file, the code calls the onComplete() method. The onComplete() method
removes the listeners for the loading events and then calls the saveFile() method. The saveFile() method calls the
FileReference.save() method. The FileReference.save() method opens a new dialog box to let the user enter
a new filename and location to save the file. The remaining event listener methods trace the progress of the file saving
process until it is complete.
In Adobe AIR, the FileStream class provides additional functionality for writing data to a local file. See “Reading and
writing files” on page 687.
Uploading files to a server
Flash Player 9 and later, Adobe AIR 1.0 and later
To upload files to a server, first call the browse() method to allow a user to select one or more files. Next, when the
FileReference.upload() method is called, the selected file is transferred to the server. If the user selects multiple
files using the FileReferenceList.browse() method, Flash Player creates an array of selected files called
FileReferenceList.fileList. You can then use the FileReference.upload() method to upload each file
individually.
Note: Using the FileReference.browse() method allows you to upload single files only. To allow a user to upload
multiple files, use the FileReferenceList.browse() method.
By default, the system file picker dialog box allows users to pick any file type from the local computer. Developers can
specify one or more custom file type filters by using the FileFilter class and passing an array of file filter instances to
the browse() method:
var imageTypes:FileFilter = new FileFilter("Images (*.jpg, *.jpeg, *.gif, *.png)", "*.jpg;
*.jpeg; *.gif; *.png");
var textTypes:FileFilter = new FileFilter("Text Files (*.txt, *.rtf)", "*.txt; *.rtf");
var allTypes:Array = new Array(imageTypes, textTypes);
var fileRef:FileReference = new FileReference();
fileRef.browse(allTypes);
When the user has selected the files and clicked the Open button in the system file picker, the Event.SELECT event is
dispatched. If the FileReference.browse() method is used to select a file to upload, the following code sends the
file to a web server:
Last updated 6/6/2012
658