cffile action = "write"

<cffile
action = "write"
file = "full pathname"
output = "content"
addNewLine = "yes|no"
attributes = "file attributes list"
charset = "character set option"
fixnewline = "yes|no"
mode = "permission">

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

action

必須

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

file

必須

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

output

必須

作成するファイルの内容です。

addNewLine

オプション

yes

• yes: ファイルに書き込まれるテキストに改行文字を追加します。
• no

attributes

オプション

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

• readOnly
• hidden
• normal

charset

オプション

JVM のデフォルトのファイル文字セット

ファイルコンテンツをエンコードする文字エンコードを指定します。一般的に使用される値を次に示します。

• utf-8
• iso-8859-1
• windows-1252
• us-ascii
• shift_jis
• iso-2022-jp
• euc-jp
• euc-kr
• big5
• euc-cn
• utf-16
  文字エンコードについて詳しくは、www.w3.org/International/O-charset.html を参照してください。

fixnewline

オプション

no

• yes: 文字列変数に埋め込まれた行終了文字を、オペレーティングシステム固有の行終了文字に変更します。
• no: 文字列変数に埋め込まれた行終了文字を変更しません。

mode

オプション

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

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

<cffile action = "write"
file = "c:\files\updates\#Form.UpdateTitle#.txt"
output = "Created By: #Form.FullName#
Date: #Form.Date#
#Form.Content#">

UpdateTitle = "FieldWork"
FullName = "World B. Frueh"
Date = "10/30/01"
Content = "We had a wonderful time in Cambridgeport."

Created By: World B. Frueh Date: 10/30/01 We had a wonderful time in Cambridgeport.

<cffile action = "write"
file = "/tmp/foo"
mode = 644>

<cffile action = "append"
destination = "/home/tomj/testing.txt"
mode = 666
output = "Is this a test?">

cffile action = "upload"
fileField = "fieldname"
destination = "/tmp/program.exe"
mode = 777>

<cfxml variable="xmlData">
<docroot>
<payload type="string">This is some plain text</payload>
</docroot>
</cfxml>
<cfset xmlString = toString(xmlData)>

<cfset key = createUUID()>
<cfset encString=encrypt(xmlString, key)>
<cffile action="write" addnewline="yes"
file="C:\ColdFusion9\wwwroot\test\store.dat"
output="#encString#" fixnewline="yes">
<cffile action="read" file="C:\ColdFusion9\wwwroot\test\store.dat"
variable="retrievedString">
<cfset decString=decrypt(retrievedString, key)>
<cfdump var="#decString#">
<cfset newXML = xmlParse(decString)>
<cfdump var="#newXML#">