日本語PDF

OracleDependency(OracleCommand)

このコンストラクタは、OracleDependencyクラスのインスタンスを作成し、OracleCommandインスタンスにバインドします。

宣言

// C#
public OracleDependency (OracleCommand cmd)

パラメータ

  • cmd

    OracleDependecyオブジェクトがバインドされるコマンド。

例外

ArgumentNullException - cmdパラメータがNULLです。

InvalidOperationException - 指定されたOracleCommandインスタンスには、すでに通知要求が含まれています。

備考

このOracleDependencyコンストラクタによりOracleCommandインスタンスがOracleDependencyインスタンスにバインドされると、OracleNotificationRequestインスタンスが作成され、OracleCommand.NotificationプロパティにそのOracleNotificationRequestインスタンスが設定されます。

連続問合せ通知は、コマンド実行時にデータベースに登録されます。コマンド実行メソッド(ExecuteNonQueryExecuteReaderなど)により、通知要求が登録されます。OracleDependencyは、複数のOracleCommandにバインドできます。これらのOracleCommandオブジェクト文のいずれかが実行されると、関連付けられているOracleCommandにその文が登録されます。個々のOracleCommandの登録は個別に発生しますが、OracleDependencyが関連付けられているすべてのOracleCommandオブジェクトに対して発生する、通知の検出および送信は1つのOracleDependencyで行うことができます。OnChangeイベントのアプリケーションに渡されるOnChangeEventArgsでは、データベース内での変更に関する情報を提供します。

このコンストラクタによって作成されるOracleNotificationRequestインスタンスのプロパティのデフォルト値は、次のとおりです。

  • IsNotifiedOnceTrueに設定されます。

  • Timeoutは50,000秒に設定されます。

  • IsPersistentFalseに設定されます。つまり、無効化メッセージに永続性はなく、配信前にインメモリー・キューに格納されます。