Spring.NET 1.3.0 RC1 for .NET 2.0 API Reference

EmsTemplate.ReceiveSelected(String) Method

Receive a message synchronously from the default destination, but only wait up to a specified time for delivery.

This method should be used carefully, since it will block the thread until the message becomes available or until the timeout value is exceeded.

This will only work with a default destination specified!

[Visual Basic]
Public NotOverridable Overloads Sub ReceiveSelected( _
   ByVal messageSelector As String _
) _
    Implements IEmsOperations.ReceiveSelected
[C#]
public Message ReceiveSelected(
   string messageSelector
);

Parameters

messageSelector
the EMS message selector expression (or
null
if none). See the EMS specification for a detailed definition of selector expressions.

Return Value

the message received by the consumer, or

null
if the timeout expires

Implements

IEmsOperations.ReceiveSelected

Exceptions

Exception TypeCondition
EMSExceptionIf there is any problem accessing the EMS API

See Also

EmsTemplate Class | Spring.Messaging.Ems.Core Namespace | EmsTemplate.ReceiveSelected Overload List