Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Arbeiten mit dem Dateisystem
FileReference-Klasse
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Jedes FileReference-Objekt stellt eine einzelne Datendatei auf dem lokalen Computer dar. Die Eigenschaften der
FileReference-Klasse umfassen Informationen zu Dateigröße, Dateityp, Dateiname, Dateinamenerweiterung,
Ersteller, Erstellungs- sowie Änderungsdatum.
Hinweis: Die creator-Eigenschaft wird nur unter MacOS unterstützt. Auf allen anderen Plattformen wird null
zurückgegeben.
Hinweis: Die extension-Eigenschaft wird nur in Adobe AIR unterstützt.
Eine Instanz der FileReference-Klasse kann mit zwei Verfahren erstellt werden:
Verwenden Sie den new-Operator, wie im folgenden Codebeispiel gezeigt:
import flash.net.FileReference;
var fileRef:FileReference = new FileReference();
Rufen Sie die Methode FileReferenceList.browse() auf. Dadurch wird ein Dialogfeld geöffnet, in dem der
Benutzer aufgefordert wird, eine oder mehrere Dateien für den Upload auszuwählen. Nachdem der Benutzer eine
oder mehrere Dateien ausgewählt hat, wird ein Array aus FileReference-Objekten erstellt.
Nach der Erstellung eines FileReference-Objekts haben Sie folgende Möglichkeiten:
Rufen Sie die FileReference.browse()-Methode auf. Dadurch wird ein Dialogfeld geöffnet, in dem der Benutzer
aufgefordert wird, genau eine Datei im lokalen Dateisystem auszuwählen. Dies erfolgt normalerweise vor einem
späteren Aufruf der Methode FileReference.upload() oder FileReference.load(). Rufen Sie die
FileReference.upload()-Methode auf, um die Datei auf einen Remoteserver hochzuladen. Rufen Sie die
FileReference.load()-Methode auf, um eine lokale Datei zu öffnen.
Rufen Sie die FileReference.download()-Methode auf. Die download-Methode öffnet ein Dialogfeld, in dem
der Benutzer ein Verzeichnis zum Speichern einer neuen Datei auswählen kann. Dann werden Daten vom Server
heruntergeladen und in der neuen Datei gespeichert.
Rufen Sie die FileReference.load()- Methode auf. Diese Methode beginnt, Daten aus einer vor Verwendung
der browse()-Methode ausgewählten Datei zu laden. Die load()-Methode kann erst aufgerufen werden, wenn
der browse()-Vorgang abgeschlossen ist (der Benutzer eine Datei auswählt).
Rufen Sie die FileReference.save()-Methode auf. Diese Methode öffnet ein Dialogfeld und fordert den
Benutzer auf, einen einzelnen Dateispeicherort im lokalen Dateisystem auszuwählen. Die Daten werden dann am
angegebenen Speicherort gespeichert.
Hinweis: Es kann immer nur jeweils eine browse()-, download()- oder save-Aktion durchgeführt werden, da immer
nur ein Dialogfeld geöffnet sein kann.
Die Eigenschaften des FileReference-Objekts, wie name, size oder modificationDate, werden erst nach einem der
folgenden Vorgänge definiert:
Die FileReference.browse()-Methode oder die FileReferenceList.browse()-Methode wurde aufgerufen
und der Benutzer hat eine Datei im Dialogfeld ausgewählt.
Die FileReference.download()-Methode wurde aufgerufen und der Benutzer hat ein neues Verzeichnis für die
Datei im Dialogfeld angegeben.
Hinweis: Während eines Downloads ist nur die Eigenschaft FileReference.name mit Daten gefüllt, bevor der
Download abgeschlossen ist. Nachdem die Datei heruntergeladen wurde, stehen alle Eigenschaften zur Verfügung.
Letzte Aktualisierung 27.6.2012
693