Optionsプロパティ

適用対象

説明

データベース、およびデータ・コントロールに関連付けられているすべてのダイナセットについて1つ以上の特性を決定します。設計時および実行時に読取り/書込みができます。

使用方法

oradata1.Options = database_optionsdatabase_options = oradata1.Options

データ型

Long Integer

備考

このプロパティは、データベースのオプションのモードを設定するために使用されるビット・フラグ文字です。options = 0の場合、デフォルトの設定が適用されます。使用可能なモードは次のとおりです。

列デフォルト・モード

デフォルト・モードは、VBモードです。VBモードでは、AddNewまたはEditの使用時、明示的に設定されていないフィールド(列)値はNULLに設定されます。

オプションで、Oracleモードも使用できます。Oracleモードでは、フィールド(列)への変更が、データベースからその変更行を取得することによって、ローカル・ミラーに即時反映され、これにより、Oracle Databaseで列にデフォルトを設定し、必要な計算を実行できます。列デフォルト・モードは、AddNewメソッドおよびEditメソッドの動作に影響します。
ロック待機モード

デフォルト・モードは、待機モードです。待機モードでは、ダイナセット行の変更を試行すると(Editを使用)、データベースの既存行が、SQL "SELECT ... FOR UPDATE"文を使用して取得され、その行はデータベースでロックされます。変更される行がすでに他のプロセス(またはユーザー)によってロックされている場合、"SELECT ... FOR UPDATE"文は、その行のロックが解除されるまで待機してから処理が実行されます。

オプションで、非待機モードも使用できます。非待機モードの場合、更新対象行がロックされていることを示すエラー・コードが即時に戻されます。

ロック待機モードは、ExecuteSQLを使用して処理されるSQL文にも影響します。
再フェッチなしモード

このモードでは、ORADB_ORAMODEの場合と同様、NULLは明示的に挿入されません。ORADB_NO_REFETCHモードでは、データがローカル・キャッシュに再フェッチされないため、パフォーマンスが向上します。

Optionsプロパティのフラグ値

Optionsプロパティのフラグ値は次のとおりです。

定数	値	説明
`ORADB_DEFAULT`	`&H0&`	デフォルトの動作を使用します。
`ORADB_ORAMODE`	`&H1&`	Oracle Databaseによるデフォルトのフィールド(列)値の設定を許可します。
`ORADB_NOWAIT`	`&H2&`	SQLの`"SELECT` `...` の実行時、行ロックで待機はしません。`FOR` `UPDATE"`文

これらの値は、oraconst.txtファイルにあります。オプションは、それぞれの値を追加することで組み合せることができます。

このプロパティは、OpenDatabaseメソッドに渡されるオプションと同じです。OpenDatabaseの場合と同様、これらのオプションは、OraDatabaseオブジェクト、およびそのデータベースから作成された関連ダイナセットすべてに影響します。

このプロパティへの変更は、Refreshメソッドがデータ・コントロールに送信された後に有効になります。