<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>CFPROCRESULT</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">CFPROCRESULT</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>
ストアードプロシージャによって返される結果セットにクエリーオブジェクトを関連付けます。cfoutput や cftable など、他の ColdFusion タグが結果セットにアクセスするときに、このクエリーオブジェクトを使用します。このタグは、cfstoredproc タグ内にネストします。 
</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;cfprocresult
   name = &quot;query_name&quot;
   resultSet = &quot;1-n&quot;
   maxRows = &quot;maxrows&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>
cfinsert、cfprocparam、cfquery、cfqueryparam、cfstoredproc、cftransaction、cfupdate、『ColdFusion MX 開発ガイド』の第13章の「ColdFusion アプリケーションの設計と最適化」 の「データベース使用の最適化」
</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>
ストアードプロシージャによって返されるデータにアクセスできるようにするには、cfprocresult タグを 1 つ以上指定します。ストアードプロシージャによって複数の結果セットが返される場合は、resultSet 属性を使用して、ストアードプロシージャのどの結果セットを返すかを指定します。
</p>

<p>
resultSet 属性には、cfstoredproc タグのスコープ内で固有の値を指定する必要があります。結果セットを 2 回指定すると、最初の指定は 2 回めの指定によって上書きされます。
</p>

<p>
CFML では、パラメータをリファレンスによって渡す Oracle 8 および 9 の Reference Cursor タイプがサポートされます。この方法で渡されるパラメータは、1 つのアプリケーションの実行において、メモリを割り当てられたり、割り当て解除されたりします。パッケージやストアードプロシージャで Reference Cursor を使用するには、cfprocresult タグを使用します。このタグを使用すると、ColdFusion JDBC データベースドライバによって Oracle Reference Cursor が結果セットに組み込まれます。Oracle の ThinClient JDBC ドライバでは、この方法を使用できません。
</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><pre>&lt;!--- この例では、3 つの結果セットを返す Sybase ストアードプロシージャを実行します。必要なのは、そのうち 
2 つの結果セットです。このストアードプロシージャは、ステータスコードと出力パラメータを 1 つ返します。そ
れらをこの例で表示します。パラメータには名前指定表記を使用します。 ---&gt;
&lt;!--- cfstoredproc タグ ---&gt;
&lt;cfstoredproc procedure = &quot;foo_proc&quot;
      dataSource = &quot;MY_SYBASE_TEST&quot;    username = &quot;sa&quot;
      password = &quot;&quot;    dbServer = &quot;scup&quot;    dbName = &quot;pubs2&quot;
      returnCode = &quot;Yes&quot;    debug = &quot;Yes&quot;&gt;
   &lt;!--- cfprocresult タグ ---&gt;
   &lt;cfprocresult name = RS1&gt;
   &lt;cfprocresult name = RS3 resultSet = 3&gt;
   &lt;!--- cfprocparam タグ ---&gt;
   &lt;cfprocparam type = &quot;IN&quot;
      CFSQLType = CF_SQL_INTEGER
         value = &quot;1&quot;    dbVarName = @param1&gt;
      
   &lt;cfprocparam type = &quot;OUT&quot;    CFSQLType = CF_SQL_DATE
      variable = FOO dbVarName = @param2&gt;
   &lt;!--- cfstoredproc タグを閉じます。 ---&gt;
&lt;/cfstoredproc&gt;
&lt;cfoutput&gt;
   出力パラメータ値 :'#foo#'&lt;br&gt;
&lt;/cfoutput&gt;
&lt;h3&gt;結果情報&lt;/h3&gt;
&lt;cfoutput query = RS1&gt;#name#,#DATE_COL#&lt;br&gt;
&lt;/cfoutput&gt;
&lt;p&gt;
&lt;cfoutput&gt;
   &lt;hr&gt;
   &lt;p&gt;レコード件数 :#RS1.recordCount# &lt;p&gt;列:#RS1.columnList#
   &lt;hr&gt;
&lt;/cfoutput&gt; 
&lt;cfoutput query = RS3&gt;#col1#,#col2#,#col3#&lt;br&gt;
&lt;/cfoutput&gt;
&lt;p&gt;
&lt;cfoutput&gt;
   &lt;hr&gt;
   &lt;p&gt;レコード件数 :#RS3.recordCount# &lt;p&gt;列:#RS3.columnList#
   &lt;hr&gt;
   ストアードプロシージャの戻りコード :
'#cfstoredproc.statusCode#'&lt;br&gt;
&lt;/cfoutput&gt;
...
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="NAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">NAME</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="RESULTSET">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">RESULTSET</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">

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


<p>ストアードプロシージャによって複数の結果セットが返される場合に、特定の結果セットの名前を指定します。</p>

  </td>
  </tr>
  </table>
</div>
<div id="MAXROWS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">MAXROWS</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">

<strong>Default value:</strong> "-1 (すべて)"


<p>結果セットに返される行の最大数です。</p>

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

  </body>
</html>
