cffile action = "rename"

説明

サーバー上のファイルの名前を変更するか、ファイルを移動します。

シンタックス

<cffile
   action = "rename"
   source = "full_path_name"
   destination = "path_name" 
   mode = "mode"
   attributes = "file_attributes_list">

関連項目

cfdirectory

ヒストリ

メインの cffile タグのページの「ヒストリ」を参照してください。

属性

属性 必須/
オプション 		デフォルト 説明

action

必須

 

このタグが実行するファイル操作のタイプです。

source

必須

 

名前を変更するファイルのパス名です。

絶対パス (ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス) を指定しなかった場合は、GetTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスになります。

destination

必須

 

変更先となるファイルまたはディレクトリです。絶対パスを指定しなかった場合は、ソースディレクトリを基準とした相対パスになります。

mode

オプション

 

UNIX および Linux だけに適用されます。許可を表す UNIX chmod コマンドの 8 進数値です。所有者、グループ、および他の利用者に割り当てられます。例 :

  • 644: 所有者に読み取り/書き込み許可、グループおよび他の利用者に読み取り許可を割り当てます。
  • 777: 利用者全員に読み取り/書き込み/実行許可を割り当てます。

attributes

オプション

 

Windows に適用されます。ファイルに設定する属性をカンマ区切りリストで指定します。

この属性を省略した場合、ファイルの属性が保持されます。

値はそれぞれ明示的に指定する必要があります。たとえば、attributes = "readOnly" を指定した場合、他の属性がすべて上書きされます。

  • hidden
  • normal
  • readOnly

使用方法

rename アクションでは、ファイルの名前を変更するか、ファイルを移動します。destination 属性には、新しいファイル名だけでなくパス名を指定する必要があります。変更先がディレクトリの場合は、ファイルの名前を変更せずに移動することになります。

例

Windows の例 :

<!--- ソースドキュメントは readOnly ですが、名前を変更すると normal (hidden や readOnly ではない) になります。 --->
<cffile action = "rename" source = "c:¥files¥memo¥readonlymemo.doc" destination = "c:¥files¥memo¥normalmemo.doc" attributes="normal">

Unix の例 :

<cffile action = "rename" source = "#myWR#/memo/sample.txt" destination = "#myWR#/memo/other_sample.txt" mode="666">

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX* | ColdFusion 5* | フォーラム* | デベロッパーセンター | サポート情報 | バグ報告

バージョン7