<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFGRIDUPDATE</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="説明">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFGRIDUPDATE</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">説明</span>
<p>
cfgrid タグ内で使用します。編集したグリッドデータからデータソースを直接更新します。このタグは、データソースへの直接のインターフェイスを提供します。
</p>

<p>
このタグでは、最初に delete 行アクションが適用され、次に insert 行アクション、最後に update 行アクションが適用されます。エラーが発生すると行の処理は停止されます。 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">カテゴリ</span>
<p>
フォームタグ
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">シンタックス</span><pre>&lt;cfgridupdate
   grid = &quot;gridname&quot;
   dataSource = &quot;data source name&quot;
   tableName = &quot;table name&quot;
   username = &quot;data source username&quot;
   password = &quot;data source password&quot;
   tableOwner = &quot;table owner&quot;
   tableQualifier = &quot;qualifier&quot;
   keyOnly = &quot;yes&quot;、&quot;no&quot;&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">関連項目</span>
<p>
cfgrid、cfgridcolumn、cfgridrow、cfform、cfapplet、cfinput、cfselect、cfslider、cftextinput、cftree
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">ヒストリ</span>
<p>
ColdFusion&#160;MX: connectString、dbName、dbServer、dbtype、provider、および providerDSN 属性は使用禁止になりました。ColdFusion 5 以降のリリースでは、これらは機能せず、エラーを引き起こす可能性があります。
</p>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">例</span>
<p>
次の例では、cfgrid タグを使用してデータベースを更新し、レコード全体を追加および削除するか、個々のセルのデータを更新します。cfgridupdate タグは、送信されたフォームのデータを処理し、データベースを更新します。
</p>
<pre>&lt;!--- gridEntered フォームが存在する場合、フォームは送信されています。
      gridupdate を実行します。 ---&gt;
&lt;cfif IsDefined(&quot;form.gridEntered&quot;) is True&gt;
   &lt;cfgridupdate grid = &quot;FirstGrid&quot; dataSource = &quot;cfsnippets&quot;
      tableName = &quot;CourseList&quot;&gt;
 &lt;/cfif&gt;

&lt;!--- データベースにクエリーを実行し、グリッドの埋め込みを行います。 ---&gt;
&lt;cfquery name = &quot;GetCourses&quot; dataSource = &quot;cfdocexamples&quot;&gt;
SELECT Course_ID, Dept_ID, CorNumber,
     CorName, CorLevel, CorDesc
FROM  CourseList
ORDER by Dept_ID ASC, CorNumber ASC
&lt;/cfquery&gt;

&lt;h3&gt;cfgrid の例&lt;/h3&gt;
&lt;i&gt;データベースにコースを追加し、次にそのコースを削除してください。&lt;/i&gt;
&lt;cfform&gt;
&lt;cfgrid name = &quot;FirstGrid&quot; width = &quot;450&quot;
   query = &quot;GetCourses&quot; insert = &quot;Yes&quot; delete = &quot;Yes&quot;
   font = &quot;Tahoma&quot; rowHeaders = &quot;No&quot; 
   colHeaderBold = &quot;Yes&quot; 
   selectMode = &quot;EDIT&quot;
   insertButton = &quot;Insert a Row&quot; deleteButton = &quot;Delete selected row&quot; &gt;
&lt;/cfgrid&gt;&lt;br&gt;
&lt;cfinput type=&quot;submit&quot; name=&quot;gridEntered&quot;&gt;
&lt;/cfform&gt;...
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="GRID">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">GRID</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>更新アクションのソースとなる cfgrid フォーム要素の名前です。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="DATASOURCE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">DATASOURCE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>更新アクションのデータソースの名前です。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="TABLENAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TABLENAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>更新するテーブルの名前です。</p>
<p>ORACLE ドライバの場合、エントリは大文字で指定する必要があります。</p>
<p>Sybase ドライバの場合、エントリは大文字と小文字を区別するため、テーブルの作成時に使用した名前と大文字小文字を同じにする必要があります。</p>

  </td>
  </tr>
  </table>
</div>
<div id="USERNAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">USERNAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ODBC セットアップ内で指定されているユーザー名の値を上書きします。</p>

  </td>
  </tr>
  </table>
</div>
<div id="PASSWORD">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">PASSWORD</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>ODBC セットアップ内で指定されているパスワードの値を上書きします。</p>

  </td>
  </tr>
  </table>
</div>
<div id="TABLEOWNER">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TABLEOWNER</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>テーブル所有者です。サポートされている場合に限ります。</p>

  </td>
  </tr>
  </table>
</div>
<div id="TABLEQUALIFIER">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TABLEQUALIFIER</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>テーブル識別子です。サポートされている場合に限ります。内容は次のとおりです。</p><ul>

<li>SQL Server および Oracle ドライバの場合: テーブルが含まれているデータベースの名前</li>

<li>Intersolv dBASE ドライバの場合: DBF ファイルのディレクトリ</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="KEYONLY">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">KEYONLY</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">&#160;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "no"


<p>update アクションに適用されます。</p><ul>

<li>yes: WHERE 条件がキー値に制限されます。</li>

<li>no: WHERE 条件には、キー値と、変更されたフィールドの元の値が含まれます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>

  </body>
</html>
