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
の場合、待機時間は無限です。