TIBCO EMS .NET API 8.4
TIBCO EMS .NET API 8.4
|
Enumerate the messages in a queue without consuming them More...
Inherits IEnumerator.
Public Member Functions | |
void | Close () |
Closes the QueueBrowser and reclaim resources More... | |
IEnumerator | GetEnumerator () |
Get an enumerator for browsing the current queue messages in the order they would be received More... | |
void | Reset () |
Reset the browser to the location just before the first message More... | |
bool | MoveNext () |
Advance the browser's enumeration to the next message More... | |
Properties | |
string | MessageSelector [get] |
Get the message selector associated with this QueueBrowser More... | |
Queue | Queue [get] |
Get the queue associated with this queue browser More... | |
Object | Current [get] |
Get the current message in the browser More... | |
Enumerate the messages in a queue without consuming them
A browser is a dynamic enumerator of the queue (not a static snapshot). The contents of the queue on the server change as messages arrive and consumers remove them. Meanwhile, a client can call the MoveNext method to advance the browser's enumeration to the next message in the queue.
The browser can enumerate messages in a queue, or a subset filtered by a message selector.
Sessions serve as factories for queue browsers; see Session.CreateBrowser. A QueueBrowser can be created from either a Session or a QueueSession.
A client uses a QueueBrowser object to look at messages on a queue without removing them.
|
inline |
Closes the QueueBrowser and reclaim resources
|
inline |
Get an enumerator for browsing the current queue messages in the order they would be received
|
inline |
Advance the browser's enumeration to the next message
A browser is a dynamic enumerator of the queue (not a static snapshot). The queue is at the server, and its contents change as message arrive and consumers remove them. Meanwhile, while the browser is at the client. This method asks the server for the next message after Current - that is, the next message that is still in the queue.
After creating a browser, programs must first call this method on the enumerator to move to the first message.
|
inline |
Reset the browser to the location just before the first message
InvalidOperationException | If queue browser is closed or has other failure. |
|
get |
Get the current message in the browser
This property presents the current message in the browser's enumeration, but accessing the property does not consume that message.
The MoveNext method advances the current message.
This property can be queried repeatly and the same message will be returned.
InvalidOperationException | If queue browser is closed or failure to get the current message, or message is null. |
|
get |
Get the message selector associated with this QueueBrowser
The browser's message selector expression filters the messages that the browser presents.
|
get |
Get the queue associated with this queue browser