WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

IMessageConsumer

應用程式會使用訊息使用端來接收送往目的地的訊息。

繼承階層:
IBM.XMS.IPropertyContext
   |
   +----IBM.XMS.IMessageConsumer

有關 XMS 所定義的 MessageConsumer 物件內容清單, 請參閱MessageConsumer 內容

.NET 內容

.NET 內容摘要:
.NET 內容 說明
MessageListener 取得已向訊息使用端登錄的訊息接聽器, 並向訊息使用端登錄一個訊息接聽器。
MessageSelector 取得訊息使用端的訊息選取器。

MessageListener – 取得和設定訊息接聽器

介面:
MessageListener MessageListener
{
  get;
  set;
}

取得已向訊息使用端登錄的訊息接聽器, 並向訊息使用端登錄一個訊息接聽器。

如果沒有向訊息使用端登錄任何訊息接聽器, 則 MessageListener 為空值。若有訊息接聽器已向訊息使用端登錄, 您可以改指定一個空值,以取消登錄。

如需使用訊息接聽器的相關資訊, 請參閱在 .NET 中使用訊息和異常狀況接聽器

異常狀況:
  • XMSException

MessageSelector – 取得訊息選取器

介面:
String MessageSelector
{
  get;
}

取得訊息使用端的訊息選取器。回覆值為一個封裝訊息選取器表示式的 String 物件。如果需要轉換資料, 則此為轉換後的訊息選取器表示式。如果訊息使用端沒有訊息選取器, 則 MessageSelector 的值會是一個空值 String 物件。

異常狀況:
  • XMSException

方法

方法摘要:
方法 說明
Close 關閉訊息使用端。
Receive 接收訊息使用端的下一則訊息。呼叫會無限期地等待訊息,或直到訊息使用端關閉為止。
Receive 接收訊息使用端的下一則訊息。呼叫只等待訊息一段指定的時間,或直到訊息使用端關閉為止。
ReceiveNoWait 接收訊息使用端的下一則訊息(若立即有的話)。

Close – 關閉訊息使用端

介面:
void  Close();

關閉訊息使用端。

如果應用程式試著關閉已關閉的訊息使用端, 則會忽略該呼叫。

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

Receive – 接收

介面:
IMessage Receive();

接收訊息使用端的下一則訊息。呼叫會無限期地等待訊息,或直到訊息使用端關閉為止。

參數:
傳回:
Message 物件的指標。在呼叫等待訊息期間,如果訊息使用端已關閉, 則方法會傳回空值 Message 物件的指標。
異常狀況:
  • XMSException

Receive – 接收(有一個等待間隔)

介面:
IMessage Receive(Int64 delay);

接收訊息使用端的下一則訊息。呼叫只等待訊息一段指定的時間,或直到訊息使用端關閉為止。

參數:
delay(輸入)
呼叫等待訊息的時間(毫秒)。如果您指定的等待間隔為 0, 呼叫會無限期地等待訊息。
傳回:
Message 物件的指標。在等待間隔期間,如果沒有訊息送達, 或者在呼叫等待訊息期間訊息使用端已關閉, 則方法會傳回空值 Message 物件的指標,但不會擲出任何異常狀況。
異常狀況:
  • XMSException

ReceiveNoWait – 接收但不等待

介面:
IMessage ReceiveNoWait();

接收訊息使用端的下一則訊息(若立即有的話)。

參數:
傳回:
Message 物件的指標。如果沒有訊息立即可用,方法會傳回空值 Message 物件的指標。
異常狀況:
  • XMSException

繼承的內容和方法


Reference topic

使用條款 | 評比此網頁

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