Collapse All Expand All

.NET Framework Class Library
TopicSession Class See Also

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

Create a nondurable subscriber to the specified topic, using a message selector or specifying whether messages published by its own connection should be delivered to it.

Namespace: TIBCO.EMS.UFO
Assembly: TIBCO.EMS.UFO (in TIBCO.EMS.UFO.dll)

# Syntax

    public TopicSubscriber CreateSubscriber(
    	Topic topic,
    	string messageSelector,
    	bool noLocal
    )

    Public Function CreateSubscriber ( _
    	topic As Topic, _
    	messageSelector As String, _
    	noLocal As Boolean _
    ) As TopicSubscriber

    public:
    TopicSubscriber^ CreateSubscriber(
    	Topic^ topic,
    	String^ messageSelector,
    	bool noLocal
    )

#### Parameters

topic
  Type: TIBCO.EMS.UFO..::.Topic
  the Topic to subscribe to

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 there is no message selector for the message consumer.

noLocal
  Type: System..::.Boolean
  if set, inhibits the delivery of messages published by its own connection

# Remarks

A client uses a TopicSubscriber object to receive messages that have been published to a topic.

Regular TopicSubscriber objects are not durable. They receive only messages that are published while they are active. Messages filtered out by a subscriber's message selector will never be delivered to the subscriber. From the subscriber's perspective, they do not exist.

In some cases, a connection may both publish and subscribe to a topic. The subscriber NoLocal attribute allows a subscriber to inhibit the delivery of messages published by its own connection. The default value for this attribute is false.

The TopicSubscriber object will be recreated during connection recovery process.

# See Also

TopicSession Class
CreateSubscriber Overload
TIBCO.EMS.UFO Namespace