DECLARE DATAROWS

構文:

>>--EXEC ADO---.--------------------.--DECLARE datarows_name DATAROWS->
               +-USING dataset_name-+

 >--.------------------------------------.—-FROM datatable_name------->
    |              +--- , ---+           |
    |              V         |           |
    +--FOR SELECT--column_name-----------+
 

 >--.-----------------------------------.—---------------------------->
    +-FOR-.-ADDED-------------.-DATAROWS+
          +-CURRENT-----------+
          +-DELETED-----------+
          +-MODIFIED CURRENT--+
          +-MODIFIED ORIGINAL-+
          +-ORIGINAL----------+
          +-UNCHANGED---------+  


 >-.----------------------------------------------------.--—END-EXEC-->< 
   |                                                    |  
   +-WHERE search_conditions--.----------------------.--+
   |                          +-ORDER BY sort_clause-+  | 
   |                                                    |
   +-WHERE CHILDREN OF cursor_name (relation_name)------+ 
   +-WHERE PARENTS  OF cursor_name (relation_name}------+    
   +-ORDER BY sort_clause-------------------------------+

パラメータ:

dataset_name 使用する DataSet 参照。dataset_name を指定しない場合は、現在の DataSet が使用されます。
datarows_name DataRows カーソルの名前。
column_name DataRows カーソルで指定する DataTable のカラムの名前。
FOR row_state DATAROWS DataTable で使用する DataRow を row_state 値に基づいて識別する。
datatable_name DataRows カーソルを定義する DataTable の名前。
search_conditions 標準の SQL WHERE 句に準拠した有効な式。
sort_clause 標準の SQL ORDER BY 句に準拠した有効な式。
cursor_name 対象の DataRows カーソルに(親または子として)関連付ける DataRows カーソルの名前。
relation_name 対象の DataRows カーソルと上記の cursor_name カーソルの親子関係を指定する制約の名前。relation_name は、DECLARE DATASET 文で定義します。

目的:

DECLARE DATAROWS 文は、特定の DataTable に対して設定されている条件に基づいて、ADO.NET DataRows カーソル(SQL カーソルと類似)を宣言します。

標準的なカーソル操作文(OPEN、FETCH、DELETE (POSITIONED)、UPDATE (POSITIONED)、および CLOSE)も ADO.NET DataRows カーソルに適用可能です。

DECLARE DATAROWS 文では、標準の WHERE 句のほかに、WHERE CHILDREN 句および WHERE PARENTS 句を使用して、関連する DataRows カーソルの親子関係を操作できます。