<CSP:QUERY>
定義済みのクラス・クエリを定義および実行します。
Synopsis
<CSP:QUERY>
属性
一般的な属性
属性 | 説明 | 値 |
---|---|---|
CLASSNAME | クエリを含むクラス名 | 有効なクラス名 (パッケージ名も含む) |
MODE | クエリの実行時モード | “LOGICAL”、“ODBC”、“DISPLAY”、“SYSTEM” |
NAME | このクエリで生成された %ResultSetOpens in a new tab オブジェクトへの参照に使用するローカル変数名 | 有効な変数名 |
P1 | 1 番目のクエリ・パラメータ値 | 文字列 |
P2 | 2 番目のクエリ・パラメータ値 | 文字列 |
P3 | 3 番目のクエリ・パラメータ値 | 文字列 |
P4 | 4 番目のクエリ・パラメータ値 | 文字列 |
QUERYNAME | クラス・クエリ名 | 有効なクエリ名 |
概要
CSP:QUERY タグは、Caché クラスで定義されたクエリを元に、%ResultSetOpens in a new tab オブジェクトを生成します。このタグは、%ResultSetOpens in a new tab オブジェクトを参照するサーバ側の変数を定義します。その名前はタグの NAME 属性で指定します。%ResultSetOpens in a new tab オブジェクトは、(タグの様々な Pn 属性で提供されたパラメータ値を使用して Execute メソッドを呼び出すことで) 自動的に実行され、ページ内で使用できる状態になります。生成された OnPage メソッドの最後で、%ResultSetOpens in a new tab オブジェクトは自動的にクローズします。
例えば、以下のコードは、Sample.PersonOpens in a new tab クラス内の ByName クエリに基づく %ResultSetOpens in a new tab オブジェクト (名前 query) をオープンし、HTML の箇条書きリスト (<UL>) にクエリの結果を表示します。
<CSP:QUERY NAME="query" CLASSNAME="Sample.Person" QUERYNAME="ByName">
<UL>
<CSP:WHILE CONDITION="query.Next()">
<LI>#(query.Get("Name"))#
</CSP:WHILE>
</UL>