[TIBCO.EMS.UFOCLIENT .NET client library 8.1 documentation]
Assembly: TIBCO.EMS.UFO (in TIBCO.EMS.UFO.dll)
Create a MessageConsumer for a specific destination,
using a message selector.
Namespace:
TIBCO.EMS.UFOAssembly: TIBCO.EMS.UFO (in TIBCO.EMS.UFO.dll)
Syntax
public MessageConsumer CreateConsumer( Destination dest, string messageSelector ) |
Public Function CreateConsumer ( _ dest As Destination, _ messageSelector As String _ ) As MessageConsumer |
public: MessageConsumer^ CreateConsumer( Destination^ dest, String^ messageSelector ) |
Parameters
- dest
- Type: TIBCO.EMS.UFO..::.Destination
The Destination to access.
- messageSelector
- Type: System..::.String
Only messages with properties matching the message selector expression are delivered. A value of null or an empty string indicates that the message consumer is to receive all messages.
Remarks
Because Queue and Topic both inherit from Destination, they can be used in the destination parameter to create a MessageConsumer.
A client uses a MessageConsumer object to receive messages that have been sent to a destination.
The MessageConsumer object will be recreated during connection recovery.
Exceptions
Exception | Condition |
---|---|
EMSException | If the session fails to create a consumer due to some internal error. |
InvalidDestinationException | If an invalid destination is specified. |
InvalidSelectorException | If the message selector is invalid. |