cffile action = "append"

説明

サーバー上のテキストファイルにテキストを追加します。

シンタックス

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

履歴

メインの cffile タグのページの「履歴」セクションを参照してください。

属性

属性	必須／オプション	デフォルト	説明
action	必須		このタグが実行するファイル操作のタイプです。
file	必須		output 属性のコンテンツの追加先となるファイルのパス名です。絶対パス（ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス）を指定しない場合は、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	オプション	いいえ	yes: 文字列変数に埋め込まれた行終了文字を、オペレーティングシステム固有の行終了文字に変更します。 no: (デフォルト) 文字列変数に埋め込まれた行終了文字を変更しません。この属性を使用する例については、「cffile action = "write"」を参照してください。
mode	オプション		UNIX および Linux だけに適用されます。許可を表す UNIX chmod コマンドの 8 進数値です。所有者、グループ、および他の利用者それぞれに割り当てられます。例 : 644: 所有者に読み取り / 書き込み許可、グループおよび他の利用者に読み取り許可を割り当てます。 777: 利用者全員に読み取り / 書き込み / 実行許可を割り当てます。

例

<cffile action = "write" file = "\temp\foo" attributes = normal output = "some text">


<cffile action = "append" file = "\temp\foo" attributes = normal output = "Is this a test?">