CFFILE ACTION = "RENAME" | |
説明
サーバー上のファイルの名前を変更するか、ファイルを移動します。 | |
シンタックス<cffile action = "rename" source = "full_path_name" destination = "path_name" mode = "mode" attributes = "file_attributes_list"> |
|
関連項目
cfdirectory |
|
ヒストリ
メインの cffile タグのページの「ヒストリ」を参照してください。
|
|
使用方法
rename アクションでは、ファイルの名前を変更するか、ファイルを移動します。destination 属性には、新しいファイル名だけでなくパス名を指定する必要があります。変更先がディレクトリの場合は、ファイルの名前を変更せずに移動することになります。 |
|
例
Windows の例 : <!--- ソースドキュメントは readOnly ですが、名前を変更すると normal (hidden や readOnly ではない) になります。 ---> <cffile action = "rename" source = "c:filesmemoreadonlymemo.doc" destination = "c:filesmemonormalmemo.doc" attributes="normal"> Unix の例 : <cffile action = "rename" source = "#myWR#/memo/sample.txt" destination = "#myWR#/memo/ other_sample.txt" mode="666"> |
ACTION | |
必須 | |
このタグが実行するファイル操作のタイプです。 |
SOURCE | |
必須 | |
名前を変更するファイルのパス名です。 絶対パス (ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス) を指定しなかった場合は、GetTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスになります。 |
DESTINATION | |
必須 | |
変更先となるファイルまたはディレクトリです。絶対パスを指定しなかった場合は、ソースディレクトリを基準とした相対パスになります。 |
MODE | |
オプション | |
UNIX および Linux だけに適用されます。許可を表す UNIX chmod コマンドの 8 進数値です。所有者、グループ、および他の利用者に割り当てられます。例 :
|
ATTRIBUTES | |
オプション | |
Windows に適用されます。ファイルに設定する属性をカンマ区切りリストで指定します。 この属性を省略した場合、ファイルの属性が保持されます。 値はそれぞれ明示的に指定する必要があります。たとえば、attributes = "readOnly" を指定した場合、他の属性がすべて上書きされます。
|