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