任意の SELECT 文（または関数・ビューの参照）を実行し、その結果を画面で扱えるようにする Field。計算列・GROUP BY・結合などを含む自由なクエリを書いて、その結果を一覧画面に表示したり、検索条件として使ったりできます。
UI は持ちません（デザイナでの設定のみ）。クエリの SELECT 列とパラメータは、モジュール内の別 Field として自動生成されます。
- 標準の DataSource テーブル連携では表現できない集計・結合・計算が必要な時
- ビューや関数の結果を画面に表示したい時
- 複雑な検索条件を SQL で記述したい時
SQL の生成は AI でクエリを作成 機能で補助できます。
| C#名 | 日本語表示名 | 説明 |
|---|---|---|
| - | フィールドタイプ | Query 固定 |
| C#名 | 日本語表示名 | 型 | 既定値 | 説明 |
|---|---|---|---|---|
| Name | 名前 | string | "" |
フィールド識別子 |
| QuerySetting | Query設定 | QuerySetting | - | SQL・ページング・ソート・Column/Parameter の詳細（「設定を開く」から編集） |
| IgnoreModification | 変更判定から除外 | bool | false |
変更検知から除外 |
任意の SELECT 文を記述します。計算列や GROUP BY、サブクエリなどが使えます。
| 値 | 挙動 |
|---|---|
| None | ページングせずに全件を 1 ページに表示 |
| System | システム標準のページングを使う。SQL がサブクエリとして利用できる必要あり。1 ページあたりの件数は PageFrame で設定しているモジュールの LimitCount に従う |
| CustomCountQuery | 全体数を求める SQL を「Count Sql」に別途記述。本体 SQL では rows_per_page / offset パラメータが渡ってくるので、それを使って 1 ページ分を取得する書き方にする |
| 値 | 挙動 |
|---|---|
| None | システムのソート条件を使わない（SQL 側で ORDER BY を書く） |
| System | システムのソート条件を使う。SQL の末尾に ORDER BY を追加できる構造にしておく |
SELECT文でa.colのように.が含まれる列名はそのまま使えない。ASを使って.を含まない別名にするSELECTのカラム名とパラメータ名は重複させない
読み取りは通常の読み取り処理を通るので、モジュールのユーザーアクセス権（読み取り）と項目単位の権限はそのまま効きます。書き込みはありません。
データによる認可（行の条件）は Query には効きません。 クエリの行は SQL 自身が定義するものなので、行の絞り込みも SQL の WHERE 句に書きます。設定されている場合はデザインチェックが知らせます。
ユーザーごとに行を絞りたい場合は、予約パラメータ current_user_id を使ってください。
サーバーが常にログインユーザーの Id を渡すため、検索条件と違って利用者が変更できず、権限として使えます。
Parameter 一覧に current_user_id（入力パラメータ、DbType はユーザー Id 列に合わせる）を登録して SQL で参照します。
SELECT dept, SUM(amount) AS total FROM orders
WHERE owner_id = @current_user_id
GROUP BY deptなお、クエリ内で他のモジュールのテーブルを結合した場合、その結合先のアクセス権は効きません。
→ 認証・認可
SQL 内で使う列とパラメータを登録します。
- 「Schema 取り込み」ボタン: 現在のモジュールの Data Source のスキーマ情報を自動登録
- Sample Value: デザイナから試し実行する際の入力値
「SQL 実行」ボタンでデザイナから実行、プレビューエリアに結果表示。
注意: 試し実行もデザイナが接続している本物の DB に対して行われます。
Query 設定で定義した Column / Parameter は、モジュール内に SQL フィールドとして自動で登録されます。ツリー上「SQL フィールド」ノードの下に並びます。
これらを通常の Field と同じように詳細 / 一覧 / 検索レイアウトにドラッグ＆ドロップすることで、表示・検索条件として使えます。
Parameter を検索条件として使う場合、IsSearchParameter にチェックすると**「単一値」スタイル**の検索フィールドとして描画されます。
完成イメージ:
ページングの System / CustomCountQuery を使う場合、1 ページあたりの件数は PageFrame で設定するモジュールの ListField Setting → LimitCount で指定します。
QueryField 自体にはスクリプト公開メンバーはありません（全 [ScriptHide]）。
Query が生成した個別の SQL フィールドに対しては、通常の Field と同じようにスクリプトからアクセスできます。
- ExecuteSqlField — 副作用ありの SQL（INSERT / UPDATE 等）を実行する
- クエリを AI で作成
- Field 共通プロパティ