ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
File property Description
creationDate The creation date of the file on the local disk.
creator Obsolete—use the extension property. (This property reports the Macintosh creator type of the file,
which is only used in Mac OS versions prior to Mac OS X.)
downloaded (AIR 2 and later) Indicates whether the referenced file or directory was downloaded (from the internet)
or not. property is only meaningful on operating systems in which files can be flagged as downloaded:
For details on these properties, see the File class entry in the ActionScript 3.0 Reference for the Adobe Flash Platform.
Copying and moving files
Adobe AIR 1.0 and later
Windows XP service pack 2 and later, and on Windows Vista
Mac OS 10.5 and later
exists Whether the referenced file or directory exists.
extension The file extension, which is the part of the name following (and not including) the final dot ("."). If there
is no dot in the filename, the extension is null.
icon An Icon object containing the icons defined for the file.
isDirectory Whether the File object reference is to a directory.
modificationDate The date that the file or directory on the local disk was last modified.
name The name of the file or directory (including the file extension, if there is one) on the local disk.
nativePath The full path in the host operating system representation. See “Paths of File objects” on page 667.
parent The folder that contains the folder or file represented by the File object. This property is null if the File
object references a file or directory in the root of the file system.
size The size of the file on the local disk in bytes.
type Obsolete—use the extension property. (On the Macintosh, this property is the four-character file type,
which is only used in Mac OS versions prior to Mac OS X.)
url The URL for the file or directory. See “Paths of File objects” on page 667.
The File class includes two methods for copying files or directories: copyTo() and copyToAsync(). The File class
includes two methods for moving files or directories: moveTo() and moveToAsync(). The copyTo() and moveTo()
methods work synchronously, and the copyToAsync() and moveToAsync() methods work asynchronously (see “AIR
file basics” on page 666).
To copy or move a file, you set up two File objects. One points to the file to copy or move, and it is the object that calls
the copy or move method; the other points to the destination (result) path.
The following copies a test.txt file from the AIR Test subdirectory of the user's documents directory to a file named
copy.txt in the same directory:
var original:File = File.documentsDirectory.resolvePath("AIR Test/test.txt");
var newFile:File = File.resolvePath("AIR Test/copy.txt");
original.copyTo(newFile, true);
In this example, the value of overwrite parameter of the copyTo() method (the second parameter) is set to true. By
setting overwrite to true, an existing target file is overwritten. This parameter is optional. If you set it to false (the
default value), the operation dispatches an IOErrorEvent event if the target file exists (and the file is not copied).
Last updated 6/6/2012
684