File オブジェクトでユーザのホームディレクトリを参照できます。Windows では、ホームディレクトリは、My Documents ディレクトリ（例えば、「C:¥Documents and Settings¥ユーザ名¥My Documents」）です。Macintosh では、Users/ユーザ名 ディレクトリです。Linux では、/home/ユーザ名 ディレクトリです。次のコードでは、ホームディレクトリの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.userDirectory.resolvePath("AIR Test");

File オブジェクトでユーザのドキュメントディレクトリを参照できます。Windows のデフォルトの場所は、My Documents ディレクトリ（例えば、「C:¥Documents and Settings¥ユーザ名¥My Documents」）です。Macintosh のデフォルトの場所は、Users/ユーザ名/Documents ディレクトリです。Linux のデフォルトの場所は、/home/ユーザ名/Documents ディレクトリです。次のコードでは、ドキュメントディレクトリの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.documentsDirectory.resolvePath("AIR Test");

File オブジェクトでデスクトップを参照できます。次のコードでは、デスクトップの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.desktopDirectory.resolvePath("AIR Test");

File オブジェクトでアプリケーション記憶領域ディレクトリを参照できます。AIR アプリケーションにはそれぞれ、アプリケーション記憶領域ディレクトリを定義する一意のパスが関連付けられています。このディレクトリは、アプリケーションおよびユーザごとに一意に割り当てられます。このディレクトリは、ユーザおよびアプリケーションに固有のデータ（ユーザデータや環境設定ファイルなど）を格納するために使用できます。例えば、次のコードでは、アプリケーション記憶領域ディレクトリに格納されている prefs.xml という環境設定ファイルを File オブジェクトで参照します。

var file = air.File.applicationStorageDirectory; 
file = file.resolvePath("prefs.xml");

アプリケーション記憶領域ディレクトリの場所は、ユーザ名、アプリケーション ID および発行者 ID に基づきます。

• Macintosh の場合

  /Users/ユーザ名/Library/Preferences/アプリケーション ID.発行者 ID/Local Store/

  次に例を示します。

  /Users/babbage/Library/Preferences/com.example.TestApp.02D88EEED35F84C264A183921344EEA353A629FD.1/Local Store

• Windows の場合（Documents and Settings ディレクトリ内）

  ユーザ名/Application Data/アプリケーション ID.発行者 ID/Local Store/

  次に例を示します。

  C:\Documents and Settings\babbage\Application Data\com.example.TestApp.02D88EEED35F84C264A183921344EEA353A629FD.1\Local Store

• Linux の場合

  /home/ユーザ名/.appdata/アプリケーション ID.発行者 ID/Local Store/

  次に例を示します。

  /home/babbage/.appdata/com.example.TestApp.02D88EEED35F84C264A183921344EEA353A629FD.1/Local Store

url で作成された File オブジェクトの （および File.applicationStorageDirectoryurl プロパティ）では、次のように app-storage URL スキーム（サポートされる URL スキームを参照）が使用されます。

var dir = air.File.applicationStorageDirectory; 
dir = dir.resolvePath("prefs.xml"); 
air.trace(dir.url); // app-storage:/preferences

File オブジェクトで、アプリケーションがインストールされたディレクトリ（アプリケーションディレクトリ）を参照できます。このディレクトリを参照するには、File.applicationDirectory プロパティを使用します。このディレクトリでは、アプリケーション記述ファイルなど、アプリケーションと共にインストールされたリソースを確認できます。例えば、次のコードでは、アプリケーションディレクトリにある images というディレクトリを File オブジェクトで参照します。

var dir = air.File.applicationDirectory; 
dir = dir.resolvePath("images");

url で作成された File オブジェクトの （および File.applicationDirectoryurl プロパティ）では、次のように app URL スキーム（サポートされる URL スキームを参照）が使用されます。

var dir = air.File.applicationDirectory; 
dir = dir.resolvePath("images"); 
air.trace(dir.url); // app:/images

File.getRootDirectories() メソッドは、すべてのルートボリュームの一覧を出力します。Windows コンピュータの場合は、C: およびマウントされたボリュームが含まれます。Macintosh および Linux の場合は、常にマシンの一意のルートディレクトリ（「/」ディレクトリ）が返されます。

File オブジェクトの nativePath プロパティを設定することにより、File オブジェクトで明示的なディレクトリを参照できます。Windows の場合の例を次に示します。

var file = new air.File(); 
file.nativePath = "C:\\AIR Test\";

重要： このような方法で明示的なパスを参照すると、コードが複数のプラットフォームにわたって機能しなくなる可能性があります。例えば、前の例は Windows 上でのみ機能します。クロスプラットフォームで機能するディレクトリを見つけるには、File.applicationStorageDirectory などの File オブジェクトの静的プロパティを使用する必要があります。次に、resolvePath() メソッド（次の節を参照）を使用して、相対パスに移動します。

resolvePath() メソッドを使用すると、別の特定のパスを基準とした相対的なパスを取得できます。例えば、次のコードでは、ユーザのホームディレクトリの AIR Test サブディレクトリを参照するように File オブジェクトを設定しています。

var file = air.File.userDirectory; 
file = file.resolvePath("AIR Test");

また、次のように、File オブジェクトの url プロパティを使用すると、URL ストリングに基づいてディレクトリを参照することもできます。

var urlStr = "file:///C:/AIR Test/"; 
var file = new air.File() 
file.url = urlStr;

詳しくは、File パスの変更を参照してください。

File クラスの browseForDirectory() メソッドを使用すると、ユーザがオブジェクトに割り当てるディレクトリを選択できるシステムダイアログボックスを表示できます。browseForDirectory() メソッドは、非同期のメソッドです。このメソッドでは、ユーザがディレクトリを選択して「開く」ボタンをクリックすると select イベントを送出し、ユーザが「キャンセル」ボタンをクリックすると cancel イベントを送出します。

例えば、次のコードでは、ユーザがディレクトリを選択できるようにし、その選択に応じたディレクトリパスを出力します。

var file = new air.File(); 
file.addEventListener(air.Event.SELECT, dirSelected); 
file.browseForDirectory("Select a directory"); 
function dirSelected(event) { 
    alert(file.nativePath); 
}

アプリケーションを起動したディレクトリの場所を取得するには、アプリケーションの起動時に送出された InvokeEvent オブジェクトの currentDirectory プロパティを確認します。詳しくは、コマンドライン引数のキャプチャを参照してください。

重要： 明示的なパスを参照すると、コードが複数のプラットフォームにわたって機能しなくなる可能性があります。例えば、C:¥foo.txt というパスは、Windows 上でのみ機能します。クロスプラットフォームで機能するディレクトリを見つけるには、File.applicationStorageDirectory などの File オブジェクトの静的プロパティを使用する必要があります。次に、resolvePath() メソッド（File パスの変更を参照）を使用して、相対パスに移動します。

次のように、File オブジェクトの url プロパティを使用すると、URL ストリングに基づいてファイルまたはディレクトリを参照できます。

var urlStr = "file:///C:/AIR Test/test.txt"; 
var file = new air.File() 
file.url = urlStr;

URL は、次のように File() コンストラクタ関数に渡すこともできます。

var urlStr = "file:///C:/AIR Test/test.txt"; 
var file = new air.File(urlStr);

url プロパティでは、常に URI エンコード形式の URL が返されます（例えば、スペースは "%20 に置き換えられます）。

file.url = "file:///c:/AIR Test"; 
alert(file.url); // file:///c:/AIR%20Test

また、File オブジェクトの nativePath プロパティを使用して明示的なパスを設定することもできます。例えば、次のコードを Windows コンピュータで実行すると、C: ドライブの AIR Test サブディレクトリにある test.txt ファイルを参照するように File オブジェクトが設定されます。

var file = new air.File(); 
file.nativePath = "C:/AIR Test/test.txt";

このパスは、次のように File() コンストラクタ関数に渡すこともできます。

var file = new air.File("C:/AIR Test/test.txt");

nativePath プロパティのパス区切り文字としては、スラッシュ（/）を使用します。Windows では、円記号（¥）も使用できますが、その場合、アプリケーションが複数のプラットフォームにわたって機能しなくなる可能性があります。

詳しくは、File パスの変更を参照してください。

File オブジェクトの getDirectoryListing() メソッドを使用すると、ディレクトリのルートレベルにあるファイルおよびサブディレクトリを参照する File オブジェクトの配列を取得することができます。詳しくは、ディレクトリの列挙を参照してください。

File クラスには、ユーザがオブジェクトに割り当てるファイルを選択できるシステムダイアログボックスを表示する以下のメソッドがあります。

• browseForOpen()

• browseForSave()

• browseForOpenMultiple()

これらのメソッドでは、いずれも非同期で処理が行われます。browseForOpen() メソッドと browseForSave() メソッドでは、ユーザがファイル（browseForSave() の場合はターゲットパス）を選択すると select イベントを送出します。browseForOpen() メソッドと browseForSave() メソッドのターゲットの File オブジェクトは、その選択に応じて、選択されたファイルを参照します。browseForOpenMultiple () メソッドでは、ユーザがファイルを選択すると selectMultiple イベントを送出します。selectMultiple イベントは FileListEvent 型のイベントで、その files プロパティに（選択されたファイルを参照する） File オブジェクトの配列が格納されます。

例えば、次のコードでは、ファイルを選択するための「開く」ダイアログボックスが表示されます。

var fileToOpen = air.File.documentsDirectory; 
selectTextFile(fileToOpen); 
 
function selectTextFile(root) 
{ 
    var txtFilter = new air.FileFilter("Text", "*.as;*.css;*.html;*.txt;*.xml"); 
    root.browseForOpen("Open", new window.runtime.Array(txtFilter)); 
    root.addEventListener(air.Event.SELECT, fileSelected); 
} 
 
function fileSelected(event) 
{ 
    trace(fileToOpen.nativePath); 
}

アプリケーションで別の参照ダイアログボックスが開かれている場合に参照メソッドを呼び出すと、ランタイムから Error 例外がスローされます。