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 以代表佇列的 Destination 物件形式,取得佇列瀏覽器的相關聯佇列。

MessageSelector – 取得訊息選取器

介面:
String MessageSelector
{
  get;
}

取得佇列瀏覽器的訊息選取器。

訊息選取器為一個封裝訊息選取器表示式的 String 物件。如果需要轉換資料, 則此為轉換後的訊息選取器表示式。如果佇列瀏覽器沒有訊息選取器,則方法會傳回空值 String 物件。

異常狀況:
  • XMSException

Queue – 取得佇列

介面:
IDestination Queue
{
  get;
}

以代表佇列的 Destination 物件形式,取得佇列瀏覽器的相關聯佇列。

異常狀況:
  • XMSException

方法

方法摘要:
方法 說明
Close 關閉佇列瀏覽器。
GetEnumerator 取得佇列上的訊息清單。

Close – 關閉佇列瀏覽器

介面:
void  Close();  

關閉佇列瀏覽器。

如果應用程式試著關閉已關閉的佇列瀏覽器, 則會忽略該呼叫。

參數:
傳回:
Void
異常狀況:
  • XMSException

GetEnumerator – 取得訊息

介面:
IEnumerator GetEnumerator();

取得佇列上的訊息清單。

此方法會傳回一個列舉元, 其中封裝了一份 Message 物件清單。Message 物件次序和從佇列擷取訊息的次序相同。如此一來, 應用程式可使用列舉元依序瀏覽每一則訊息。

只要訊息被放到佇列上以及從佇列中移除時, 即會動態更新列舉元。每當應用程式呼叫 IEnumerator.MoveNext() 以瀏覽佇列中的下一則訊息時, 訊息會反映佇列的現行內容。

如果應用程式針對給定的佇列瀏覽器呼叫此方法多次, 則每次的呼叫都會傳回一個新列舉元。如此一來,應用程式可使用一個以上的列舉元來瀏覽佇列上的訊息, 並維護佇列中的多個位置。

參數:
傳回:
Iterator 物件。
異常狀況:
  • XMSException

繼承的內容和方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)