Directory データタイプ

Directory データタイプは、システムディレクトリーの管理を可能にします。このデータタイプを使用すると、システムディレクトリーやファイルにわたって処理を実行するアプリケーションを簡単に開発できます。
このデータタイプは、ディレクトリーの作成、コピー、移動、名前の変更、削除といった標準的な操作に使用します。また、ディレクトリーの項目属性 (修正日、時間、サイズなど) を取得する場合にも使用できます。

プロパティ

Source	指定したパスのディレクトリーを選択します。
ErrCode	最後の操作の結果を返します。次のいずれかの値が戻されます: 0: 操作が正常に終了した場合 1: ディレクトリーインスタンスが無効の場合 ( [ Source ] プロパティが設定されていなかった場合) 2: ディレクトリーが存在しない場合 3: ディレクトリーが既に存在する場合 4: ディレクトリーが空でない場合 100: セキュリティエラー -1: 未定義のエラー
ErrDescription	最後の操作の結果に関する説明を返します。

静的プロパティ

ApplicationDataPath	アプリケーションに関連するファイルが保存されているディレクトリー。
TemporaryFilesPath	アプリケーションの一時ファイルが保存されているディレクトリーです。 C# - Path.GetTempPath() メソッドを使用して実装されます。 Java - System.getProperty("java.io.tmpdir") の戻り値を返します。
ExternalFilesPath	外部ストレージデバイス (存在する場合) のパス。存在しない場合、このプロパティは、 [ ApplicationDataPath ] プロパティの値になります。
CacheFilesPath	アプリケーションのキャッシュファイルが保存されているディレクトリーです。

このデータタイプの静的プロパティについては、「[ Directory Data Type Static ] プロパティ」を参照してください。
注: CacheFilesPath は GeneXus 16 Upgrade 4 以降の iOS ジェネレーターで使用できます。
CacheFilesPath は GeneXus 16 Upgrade 9 以降の Android ジェネレーターで使用できます。

メソッド

Create

指定したソースに新しいディレクトリーを作成します。

パラメーター

ディレクトリー名 (文字)

例

&directory.Source="c:\temp"
&directory.create()

Delete

ソースディレクトリーを削除します。

例

&directory.delete()

Exists

ソース内で指定したファイルが存在するかどうか確認します。

戻り値

Boolean

例

If &directory.exists() 
    Msg("The directory exists!")Else
    Msg("The directory does not exist!")EndIf

GetName

ソースディレクトリーの名前を返します。

戻り値

Character

例

&directory.Source = "c:\temp"
Msg(&directory.GetName()) // 画面表示: temp

GetAbsoluteName

ソースディレクトリーの絶対名を返します。

戻り値

Character

例

&directory.Source="c:\temp"
Msg(&directory.GetAbsoluteName()) // 画面表示: c:\temp

Rename

ソースディレクトリーの名前を変更します。現在のパスを変更してディレクトリーを移動することもできます。

パラメーター

ディレクトリーの新しい名前 (文字) です。

例

&directory.Rename("d:\temp2")

GetFiles

ソースディレクトリー内のファイルの名前を返します。拡張子のワイルドカードや終了パターンを使用してフィルタを指定できます。

パラメーター

フィルタ (文字)

例

for &auxFile in &directory.GetFiles('*.txt')
   // do something with .txt auxFile         
endfor

ここで、&auxFile は File 変数として定義されます。

GetDirectories

ソースディレクトリー内のすべてのディレクトリーの名前を返します。

例

for &auxDir in &directory.GetDirectories()
  // auxDir に対する何らかの処理
endfor

ここで、&auxDir は Directory 変数として定義されます。