CFUPDATE | |
説明
ColdFusion フォームまたは Form スコープ内のデータからデータソース内のレコードを更新します。 |
|
カテゴリ
データベース操作タグ | |
シンタックス<cfupdate dataSource = "ds_name" tableName = "table_name" tableOwner = "name" tableQualifier = "qualifier" username = "username" password = "password" formFields = "field_names"> |
|
関連項目
cfinsert、cfprocparam、cfprocresult、cfquery、cfqueryparam、cfstoredproc、cftransaction、『ColdFusion MX 開発ガイド』の第21章の「データベースの更新」 の「cfupdate を使用した更新アクションページの作成」 |
|
ヒストリ
ColdFusion MX: connectString、dbName、dbServer、dbtype、provider、および providerDSN 属性は使用禁止になりました。ColdFusion 5 以降のリリースでは、これらは機能せず、エラーを引き起こす可能性があります。
|
|
例<!--- この例では、従業員テーブル内の個人の電話番号を更新することができます。 ---> <cfif isDefined("form.phone")> <cfupdate datasource="cfdocexamples" tablename="Employees"> </cfif> <cfquery name="empTable" datasource="cfdocexamples"> select * from employees </cfquery> <!--- このコードにより、従業員テーブルのコンテンツが表示され、更新対象の行を選択できるようになります。 ---> <table border="1"> <cfoutput query="empTable"> <tr> <td>#firstName#</td> <td>#lastName#</td> <td>#phone#</td> <td><a href="cfupdate.cfm?id=#emp_id#">Edit</a></td> </tr> </cfoutput> </table> <cfif isDefined("url.id")> <cfquery name="phoneQuery" datasource="cfdocexamples"> select * from employees where emp_id=#url.id# </cfquery> <!--- このコードにより、更新するために編集する行が表示されます。 ---> <cfoutput query="phoneQuery"> <form action="cfupdate.cfm" method="post"> #phoneQuery.firstName# #phoneQuery.lastName# <input name="phone" type="text" value="#phone#" size="12"> <input type="submit" value="Update"> <input name="emp_id" type="hidden" value="#emp_id#"> <!--- emp_id は、CFUPDATE でプライマリーキーとして使用する非表示フィールドとして 渡されます。 ---> </form> </cfoutput> </cfif> |
DATASOURCE | |
必須 | |
テーブルが含まれているデータソースの名前です。 |
TABLENAME | |
必須 | |
更新するテーブルの名前です。
|
TABLEOWNER | |
オプション | |
テーブル所有権がサポートされているデータソース (SQL Server、Oracle、Sybase SQL Anywhere など) の場合は、テーブルの所有者です。 |
TABLEQUALIFIER | |
オプション | |
テーブル修飾子がサポートされているデータソースに使用します。テーブル修飾子の内容は次のとおりです。
|
USERNAME | |
オプション | |
ODBC セットアップで指定されている username の値よりも優先されます。 |
PASSWORD | |
オプション | |
ODBC セットアップで指定されている password の値よりも優先されます。 |
FORMFIELDS | |
オプション | |
Default value: "(キーを除くフォーム上のすべて)"
更新するフォームフィールドのカンマ区切りリストです。 フォームフィールドがデータベース内の列名と一致しない場合は、エラーが発生します。 formFields のリストには、データベーステーブルのプライマリキーフィールドを含める必要があります。このフィールドがフォームに存在している必要があります。このフィールドは非表示にできます。 |