Flash CS3 ドキュメンテーション

ActionScript 2.0 の学習 > 外部データの操作 > ファイルのアップロードとダウンロードについて

ファイルのアップロードとダウンロードについて

FileReference クラスには、クライアントコンピュータとサーバーとの間でファイルのアップロードおよびダウンロードを行う機能を追加するための手段があります。ユーザーは自分のコンピュータとサーバーとの間で、ファイルを自由にアップロード、ダウンロードできるようになります。ユーザーはアップロードするファイルや、(Windows オペレーティングシステムの [開く] ダイアログボックスなど) ダイアログボックス内でダウンロードする場所を指定するよう要求されます。

ActionScript で作成した各 FileReference オブジェクトは、ユーザーのハードディスクにある同じファイルを参照します。このオブジェクトには、ファイルのサイズ、種類、名前、作成日、および変更日に関する情報が含まれています。Macintosh の場合は、さらにファイルのクリエータタイプに関するプロパティが含まれます。

FileReference クラスのインスタンスを作成する方法は 2 種類あります。次の new 演算子を使用することができます。

import flash.net.FileReference;
var myFileReference:FileReference = new FileReference();

あるいは、FileReferenceList.browse() メソッドを呼び出します。このメソッドは、ユーザーによるファイルの選択が正常に行われた場合に、ユーザーのシステム上でダイアログボックスを開き、アップロードするファイルを選択し、次に FileReference オブジェクトの配列を作成します。各 FileReference オブジェクトは、ユーザーがダイアログボックスで選択したファイルを表します。FileReference.browse() メソッドまたは FileReferenceList.browse() メソッドが呼び出され、ユーザーがファイルピッカーからファイルを選択するか、FileReference.download() メソッドを使用してファイルピッカーからファイルを選択するまで、FileReference オブジェクトの FileReference プロパティには (name、size、または modificationDate などの) データはありません。

browse() メソッドの呼び出しが正常に終了した後、FileReference.upload() を呼び出して、1 回に 1 つずつファイルをアップロードします。

Flash アプリケーションにダウンロード機能を追加することもできます。FileReference.download() メソッドでは、エンドユーザーはサーバーからのファイルを保存する場所をハードディスクに設定することを要求されます。このメソッドでは、リモート URL からのダウンロードも開始されます。download() メソッドを使用する場合、onSelect イベントが送出されると、FileReference.name プロパティだけにアクセスできるようになります。残りのプロパティについては、onComplete イベントが送出されるまでアクセスできません。

FileReference API の機能およびセキュリティの詳細については、FileReference API の機能とセキュリティについてを参照してください。FileReference API を使用するアプリケーションの例については、アプリケーションへのファイルアップロード機能の追加を参照してください。この例のサンプルソースファイルである "FileUpload.fla" については、Flash サンプルページ (www.adobe.com/go/learn_fl_samples_jp) を参照してください。"Samples" zip ファイルをダウンロードして、"ActionScript2.0/FileUpload" フォルダに移動してサンプルにアクセスします。

FileReference API の各メソッド、プロパティ、およびイベントについては、『ActionScript 2.0 リファレンスガイド』の「FileReference (flash.net.FileReference)」および「FileReferenceList (flash.net.FileReferenceList)」を参照してください。

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/main/00001052.html

コメントの追加