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