プライマリ・コンテンツに移動
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の場合、待機時間は無限です。