QUERYNEW  
説明

空のクエリー (クエリーオブジェクト) を作成します。

 
戻り値

指定した名前の一連の列を持つ空のクエリー、または列を持たない空のクエリー

 
カテゴリ

クエリー関数

 
関数のシンタックス
QueryNew(columnlist [, columntypelist])
 
ヒストリ

ColdFusion MX 7: columntypelist パラメータが追加されました。

 
関連項目

QueryAddColumn、QueryAddRow、QuerySetCell、『ColdFusion MX 開発ガイド』の第22章の「クエリーオブクエリーの使用」 の「列のデータタイプの管理」

 
パラメータ

 
使用方法

columnlist パラメータで空の文字列を指定した場合は、QueryAddColumn 関数を使用してクエリーに列を追加する必要があります。

オプションの columntypelist パラメータを使用することをお勧めします。このパラメータを使用しない場合、ColdFusion ではクエリーオブクエリー内のクエリーオブジェクトを使用するときに、データタイプを判別する必要があります。データタイプを判別するには追加処理が必要であり、ColdFusion がデータタイプを正しく推測しない場合、エラーが発生する可能性があります。

 

次の例では、QueryNew 関数を使用して、3 つの列がある空のクエリーを作成します。クエリーの 2 つの行を挿入し、クエリーオブジェクトの内容およびそのメタデータを表示します。

<!--- 3 列で構成された新規クエリーを作成し、列のデータタイプを指定 --->
<cfset myQuery = QueryNew("Name, Time, Advanced", "VarChar, Time, Bit")>

<!--- クエリー内に行を 2 つ作成 --->
<cfset newRow = QueryAddRow(MyQuery, 2)>

<!--- クエリー内のセルの値を設定 --->
<cfset temp = QuerySetCell(myQuery, "Name", "The Wonderful World of CMFL", 1)>
<cfset temp = QuerySetCell(myQuery, "Time", "9:15 AM", 1)>
<cfset temp = QuerySetCell(myQuery, "Advanced", False, 1)>
<cfset temp = QuerySetCell(myQuery, "Name", "CFCs for Enterprise
      Applications", 2)>
<cfset temp = QuerySetCell(myQuery, "Time", "12:15 PM", 2)>
<cfset temp = QuerySetCell(myQuery, "Advanced", True, 2)>

<h4>クエリーオブジェクトの内容</h4>
<cfoutput query = "myQuery">
   #Name# #Time# #Advanced#<br>
</cfoutput><br>
<br>
<h4>個々のクエリーデータ値の使用</h4>
<cfoutput>
   #MyQuery.name[2]# is at #MyQuery.Time[2]#<br>
</cfoutput><br>
<br>
<h4>クエリーメタデータ</h4>
<cfset querymetadata=getMetaData(myQuery)>
<cfdump var="#querymetadata#">
COLUMNLIST  
カンマで区切った列名のリスト、または空の文字列を指定します。
COLUMNTYPELIST  
(オプション) 列のデータタイプを指定する、カンマで区切ったリストです。列に追加したデータ がこのタイプではない場合、またはデータをこのタイプに変換できない場合、ColdFusion ではエ ラーが生成されます。次のデータタイプが有効です。
  • Integer: 32 ビットの整数です。
  • BigInt: 64 ビットの整数です。
  • Double: 64 ビットの小数です。
  • Decimal: java.math.BigDecimal で指定される、可変長の小数です。
  • VarChar: 文字列です。
  • Binary: バイト配列です。
  • Bit: ブール値 (1 = true、0 = false) です。
  • Time: 時刻です。
  • Date: 日付です。時刻情報を含めることができます。