cffile action = "rename"

<cffile
action = "rename"
destination = "pathname"
source = "full pathname"
attributes = "file attributes list"
mode = "mode">

注意：このタグの属性は attributeCollection 属性で指定でき、その値は構造体になります。attributeCollection 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。

action

必須

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

destination

必須

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

source

必須

名前を変更するファイルのパス名です。絶対パス（ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス）を指定しない場合は、GetTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスを指定します。

attributes

オプション

Windows に適用されます。ファイルに設定する属性をカンマ区切りリストで指定します。
この属性を省略した場合、ファイルの属性が保持されます。値はそれぞれ明示的に指定する必要があります。例えば、attributes = "readOnly" を指定した場合、他の属性がすべて上書きされます。

• readOnly
• hidden
• normal

mode

オプション

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

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

<!--- Source Document is read-only but when renamed it becomes normal (not hidden or
read-only). --->
<cffile action = "rename" source = "c:\files\memo\readonlymemo.doc"
destination = "c:\files\memo\normalmemo.doc" attributes="normal">