[TIBCO.EMS.UFOCLIENT .NET client library 7.0 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

ExceptionCondition
EMSExceptionIf the session fails to create a consumer due to some internal error.
InvalidDestinationExceptionIf an invalid destination is specified.
InvalidSelectorExceptionIf the message selector is invalid.

See Also