Collapse All Expand All

.NET Framework Class Library
Session Class See Also

[TIBCO.EMS.UFOCLIENT .NET client library 5.1 documentation]

Create a MessageConsumer for a specific destination, using a message selector.

Namespace: TIBCO.EMS.UFO
Assembly: 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.

# See Also

Session Class
CreateConsumer Overload
TIBCO.EMS.UFO Namespace