Listen(OracleConnection, OracleAQAgent[ ], int)
この静的メソッドは、OracleAQAgent
オブジェクトの配列に指定された1つ以上のコンシューマについて、1つ以上のキューでメッセージをリスニングします。OracleAQAgent
オブジェクトのName
プロパティはコンシューマの名前を表し、OracleAQAgent
オブジェクトのAddress
プロパティはキューの名前を表します。
タイムアウトした場合、このメソッドはnull
を戻します。
宣言
// C# public static OracleAQAgent Listen(OracleConnection con, OracleAQAgent[] listenConsumers, int waitTime);
パラメータ
-
con
OracleConnection
インスタンス。 -
listenConsumers
リスニングされるコンシューマの配列。単一コンシューマ・キューの場合は、
OracleAQAgent
オブジェクトの名前をnull
または空にする必要があります。 -
waitTime
待機時間(秒)。
戻り値
OracleAQAgent
オブジェクト。
例外
ArgumentNullException
- con
またはlistenConsumers
パラメータがnullです。
InvalidOperationException
- 接続がオープンされていません。
ArgumentException
- waitTime
が-1未満です。
備考
Listen
は、いずれかのキューでコンシューマがメッセージを使用できるようになるまで複数のキューを監視する必要がある場合に便利です。OracleAQAgent
オブジェクトのName
プロパティはコンシューマの名前を表し、OracleAQAgent
オブジェクトのAddress
プロパティはキューの名前を表します。
waitTime
が-1
の場合、待機時間は無限です。
このコールは、リスト内のコンシューマがメッセージを消費できるようになるまでコール元のスレッドをブロックします。このコールは、デキュー可能になったメッセージのコンシューマとキューを指定するOracleAQAgent
オブジェクトを戻します。