QueryAddRow

説明

指定した数の空の行をクエリーに追加します。

戻り値

クエリーの行数

カテゴリ

クエリー関数

関数のシンタックス

QueryAddRow(query [, number])

関連項目

QueryAddColumnQuerySetCellQueryNew、『ColdFusion アプリケーションの開発』のCreating a recordset with the QueryNew() function

パラメータ

パラメータ

説明

query

実行するクエリーの名前です。

number

クエリーに追加する行の数です。デフォルト値は 1 です。

使用方法

ColdFusion 10 での機能強化により、構造体、構造体の配列、または 1 次元または多次元の配列を指定して、クエリに行を追加できるようになりました。次に例を示します。

queryAddRow(myQuery1, 
     [ 
                {id=2,name="Two"}, 
                {id=3,name="Three"}, 
                {id=4,name="Four"} 
]); 
queryAddRow(myQuery2,{id=4,name="Four"});
queryAddRow(myQuery1, 
[ 
[1,"One"], 
[2,"Two"], 
{3,"Three"] 
      ]); 

<h3>QueryAddRow Example</h3> 
 
<!--- start by making a query ---> 
<cfquery name = "GetCourses" datasource = "cfdocexamples"> 
    SELECT Course_ID, Number, Descript  
    FROM Courses 
</cfquery> 
 
<p>The Query "GetCourses" has <cfoutput>#GetCourses.RecordCount#</cfoutput> rows. 
 
<cfset CountVar = 0> 
<cfloop CONDITION = "CountVar LT 15"> 
    <cfset temp = QueryAddRow(GetCourses)> 
    <cfset CountVar = CountVar + 1> 
    <cfset Temp = QuerySetCell(GetCourses, "Number", 100*CountVar)> 
    <cfset Temp = QuerySetCell(GetCourses, "Descript",  
    "Description of variable #Countvar#")> 
</cfloop> 
 
<P>After the QueryAddRow action, the query has <CFOUTPUT>#GetCourses.RecordCount#</CFOUTPUT>  
records. 
<CFOUTPUT query="GetCourses">  
<PRE>#Course_ID# #Number# #Descript#</pre> 
</cfoutput>