CFFILE ACTION = "WRITE" | |
説明
ダイナミックコンテンツをベースにして、サーバーにテキストファイルを書き込みます。コンテンツからスタティックな HTML ファイルを作成したり、テキストファイル内にアクションを記録したりできます。 | |
シンタックス<cffile action = "write" file = "full_path_name" output = "content" mode = "permission" addNewLine = "yes"、"no" attributes = "file_attributes_list" charset = "charset_option" > |
|
関連項目
cfdirectory |
|
ヒストリ
メインの cffile タグのページの「ヒストリ」を参照してください。
|
|
例
この例では、ユーザーが HTML 挿入フォームに入力した情報を使用してファイルを作成します。 <cffile action = "write" file = "c:filesupdates#Form.UpdateTitle#.txt" output = "作成者 :#Form.FullName# 作成日 :#Form.Date# #Form.Content#"> ユーザーが次のフォームを送信した場合、 UpdateTitle = "FieldWork" FullName = "World B. Frueh" Date = "10/30/01" Content = "Cambridgeport で楽しい時間を過ごした。" c:filesupdates ディレクトリに FieldWork.txt という名前のファイルが作成され、ファイルに次のテキストが加えられます。 作成者 : World B. Frueh 作成日 : 10/30/01 Cambridgeport で楽しい時間を過ごした。 この例は、UNIX での mode 属性の使用方法を示しています。ファイル /tmp/foo を作成し、rw-r--r-- (owner = read/write, group = read, other = read) というアクセス許可を指定します。 <cffile action = "write" file = "/tmp/foo" mode = 644> この例では、ファイルへの追加を行い、利用者全員に読み取り/書き込み (rw) 許可を設定します。 <cffile action = "append" destination = "/home/tomj/testing.txt" mode = 666 output = "これはテストですか?"> この例では、ファイルをアップロードして、アクセス許可を owner/group/other = read/write/execute に設定します。 cffile action = "upload" fileField = "fieldname" destination = "/tmp/program.exe" mode = 777> この例では、fixnewline 属性を使用して、xmlData から派生する xmlString に埋め込まれた行終了文字を、オペレーティングシステム固有の行終了文字に変更します。 <cfxml variable="xmlData"> <docroot> <payload type="string">これはプレーンテキストです。</payload> </docroot> </cfxml> <cfset xmlString = toString(xmlData)> <cfset key = createUUID()> <cfset encString=encrypt(xmlString, key)> <cffile action="write" addnewline="yes" file="C:CFusionMX7wwwrootteststore.dat" output="#encString#" fixnewline="yes"> <cffile action="read" file="C:CFusionMX7wwwrootteststore.dat" variable="retrievedString"> <cfset decString=decrypt(retrievedString, key)> <cfdump var="#decString#"> <cfset newXML = xmlParse(decString)> <cfdump var="#newXML#"> |
ACTION | |
必須 | |
このタグが実行するファイル操作のタイプです。 |
FILE | |
必須 | |
書き込み先となるファイルのパス名です。 絶対パス (ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス) を指定しなかった場合は、GetTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスになります。 |
OUTPUT | |
必須 | |
作成するファイルの内容です。 |
MODE | |
オプション | |
UNIX および Linux だけに適用されます。許可を表す UNIX chmod コマンドの 8 進数値です。所有者、グループ、および他の利用者それぞれに割り当てられます。例 :
|
ADDNEWLINE | |
オプション | |
Default value: "yes"
|
ATTRIBUTES | |
オプション | |
Windows に適用されます。ファイルに設定する属性をカンマ区切りリストで指定します。 この属性を省略した場合、ファイルの属性が保持されます。 値はそれぞれ明示的に指定する必要があります。たとえば、attributes = "readOnly" を指定した場合、他の属性がすべて上書きされます。
|
CHARSET | |
オプション | |
Default value: "JVM のデフォルトのファイル文字セット"
ファイルコンテンツをエンコードする文字エンコードを指定します。一般的に使用される値を次に示します。
文字エンコードの詳細については、www.w3.org/International/O-charset.html を参照してください。 |
FIXNEWLINE | |
オプション | |
Default value: "No"
|