WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 オペレーティング・システム: Linux, Windows

IQueueBrowser

アプリケーションは、キュー・ブラウザーを使用してキューのメッセージを参照します。このとき、メッセージは除去されません。

継承の階層:
IBM.XMS.IPropertyContext
System.Collections.IEnumerable
|
+----IBM.XMS.IQueueBrowser

.NET プロパティー

.NET プロパティーの要約:
.NET プロパティー 説明
MessageSelector キュー・ブラウザーのメッセージ・セレクターを取得します。
Queue キュー・ブラウザーに関連付けられたキューを、キューを表す宛先オブジェクトとして取得します。

MessageSelector – メッセージ・セレクターの取得

インターフェース:
String MessageSelector
{
get;
}

キュー・ブラウザーのメッセージ・セレクターを取得します。

メッセージ・セレクターは、メッセージ・セレクター式をカプセル化している String オブジェクトです。データ変換が必要な場合、これは変換後のメッセージ・セレクター式です。キュー・ブラウザーにメッセージ・セレクターが存在しない場合、このメソッドはヌルの String オブジェクトを戻します。

例外:
  • XMSException

Queue – キューの取得

インターフェース:
IDestination Queue
{
get;
}

キュー・ブラウザーに関連付けられたキューを、キューを表す宛先オブジェクトとして取得します。

例外:
  • XMSException

メソッド

メソッドの要約:
メソッド 説明
Close キュー・ブラウザーを閉じます。
GetEnumerator キュー上のメッセージのリストを取得します。

Close – キュー・ブラウザーのクローズ

インターフェース:
void Close();

キュー・ブラウザーを閉じます。

アプリケーションが、既に閉じているキュー・ブラウザーを閉じようとした場合、呼び出しは無視されます。

パラメーター:
なし
戻り値:
void
例外:
  • XMSException

GetEnumerator – メッセージの取得

インターフェース:
IEnumerator GetEnumerator();

キュー上のメッセージのリストを取得します。

このメソッドは、Message オブジェクトのリストをカプセル化する列挙子を戻します。Message オブジェクトの順序は、メッセージがキューから取り出される順序と同じ です。アプリケーションは列挙子を使用して、各メッセージを順番に参照できます。

メッセージがキューに書き込まれたり削除されたりすると、列挙子は動的に更新されます。 アプリケーションがキュー上の次のメッセージを参照するために IEnumerator.MoveNext() を呼び出すたびに、メッセージはキューの現在の内容を反映しています。

アプリケーションが特定のキュー・ブラウザーに対してこのメソッドを複数回呼び出すと、そのたびに新しい列挙子が戻ります。したがって、アプリケーションは複数の列挙子を使用してキューのメッセージを参照し、キュー内の複数の位置を維持することができます。

パラメーター:
なし
戻り値:
Iterator オブジェクト。
例外:
  • XMSException

継承されたプロパティーおよびメソッド


Reference topic

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 8 Jun 2006
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)