プライマリ・コンテンツに移動

Oracle® Data Provider for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88311-03 |
| 目次 | 索引

前 | 次 |

# Listen (string[], int)

このメソッドは、指定された時間にわたり、`listenConsumers`に代わってメッセージをリスニングします。

宣言

    // C#
    public string Listen(string[] listenConsumers, int waitTime);

パラメータ

- `listenConsumers`

  このキューでリスニングするコンシューマの配列。

- `waitTime`

  待機時間(秒)。

戻り値

`string`

例外

`InvalidOperationException` - 接続がオープンされていません。

ArgumentException - `waitTime`が`-1`未満です。

`ObjectDisposedException` - オブジェクトはすでに処理されています。

備考

`Listen`は、`listenConsumers`に指定された名前のコンシューマがキュー内のメッセージを使用できるようになるまで待つ必要がある場合に便利です。

このコールは、`listenConsumers`配列内のコンシューマがメッセージを消費できるようになるまでコール元のスレッドをブロックします。このコールは、消費可能になったメッセージのコンシューマ名を表す`string`を戻します。タイムアウトが発生した場合、このメソッドは`null`を戻します。

単一コンシューマ・キューの場合は、`listenConsumers`パラメータを`null`にする必要があります。そのような場合は空の文字列が戻されます。

`waitTime`が`-1`の場合、待機時間は無限です。

関連項目:

- Oracle.DataAccess.ClientおよびOracle.ManagedDataAccess.Clientのネームスペース

- OracleAQQueueクラス

- OracleAQQueueメンバー