ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
}
}
{
}
trace("File was successfully loaded.");
trace(fileRef.data);
public function onCancel(evt:Event):void
{
trace("The browse request was canceled by the user.");
}
public function onIOError(evt:IOErrorEvent):void
{
trace("There was an IO Error.");
}
public function onSecurityError(evt:Event):void
{
trace("There was a security error.");
}
The example code first creates the FileReference object named fileRef and then calls its browse() method. The
browse() method opens a dialog box that prompts the user to select a file. When a file is selected, the code invokes the
onFileSelected() method. This method adds listeners for the progress and complete events and then calls the
FileReference object’s load() method. The other handler methods in the example simply output messages to report
on the progress of the load operation. When the loading completes, the application displays the contents of the loaded
file using the trace() method.
In Adobe AIR, the FileStream class provides additional functionality for reading data from a local file. See “Reading
and writing files” on page 687.
Saving data to local files
Flash Player 9 and later, Adobe AIR 1.0 and later
The FileReference.save() method lets you save data to a local file. It starts by opening a dialog box to let the user
enter a new filename and location to which to save a file. After the user selects the filename and location, the data is
written to the new file. When the file is saved successfully, the properties of the FileReference object are populated with
the properties of the local file.
Note: Your code can only call the FileReference.save() method in response to a user-initiated event such as a mouse
click or a keypress event. Otherwise an error is thrown. This restriction does not apply to content running in Adobe AIR
in the application security sandbox.
The FileReference.save() method returns immediately after being called. The FileReference object then
dispatches events to call listener methods at each step of the file saving process.
The FileReference object dispatches the following events during the file saving process:
select event (Event.SELECT): Dispatched when the user specifies the location and file name for the new file to be
saved.
cancel event (Event.CANCEL): Dispatched when the user click the Cancel button in the dialog box.
open event (Event.OPEN): Dispatched when the save operation starts.
progress event (ProgressEvent.PROGRESS): Dispatched periodically as bytes of data are saved to the file.
Last updated 6/6/2012
655