SubscriptionClient.Receive Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
Receive() |
Receives a message using the Microsoft.ServiceBus.Messaging.SubscriptionClient.InternalReceiver. |
Receive(Int64) |
Receives a deferred message using the Microsoft.ServiceBus.Messaging.SubscriptionClient.InternalReceiver. This method only works for deferred message, not regular one. |
Receive(TimeSpan) |
Receives a message using the Microsoft.ServiceBus.Messaging.SubscriptionClient.InternalReceiver. |
Receive()
Receives a message using the Microsoft.ServiceBus.Messaging.SubscriptionClient.InternalReceiver.
public Microsoft.ServiceBus.Messaging.BrokeredMessage Receive ();
abstract member Receive : unit -> Microsoft.ServiceBus.Messaging.BrokeredMessage
override this.Receive : unit -> Microsoft.ServiceBus.Messaging.BrokeredMessage
Public Function Receive () As BrokeredMessage
Returns
The BrokeredMessage that represents the received message.
Exceptions
Thrown when the subscription does not exist.
Thrown if the operation exceeded the timeout value set via OperationTimeout.
Thrown if the client entity has been closed or aborted.
Thrown if there is an authentication error.
Remarks
A Null can be return by this API if operation exceeded the timeout specified, or the operations succeeded but there are no more messages to be received.
Applies to
Receive(Int64)
Receives a deferred message using the Microsoft.ServiceBus.Messaging.SubscriptionClient.InternalReceiver. This method only works for deferred message, not regular one.
public Microsoft.ServiceBus.Messaging.BrokeredMessage Receive (long sequenceNumber);
abstract member Receive : int64 -> Microsoft.ServiceBus.Messaging.BrokeredMessage
override this.Receive : int64 -> Microsoft.ServiceBus.Messaging.BrokeredMessage
Public Function Receive (sequenceNumber As Long) As BrokeredMessage
Parameters
- sequenceNumber
- Int64
The sequence number of the deferred message to receive.
Returns
The BrokeredMessage that represents the received message.
Exceptions
Thrown if the client entity has been closed or aborted.
Remarks
A Null can be return by this API if operation exceeded the timeout specified, or the operations succeeded but the message with the requested sequenceNumber cannot be located.
Applies to
Receive(TimeSpan)
Receives a message using the Microsoft.ServiceBus.Messaging.SubscriptionClient.InternalReceiver.
public Microsoft.ServiceBus.Messaging.BrokeredMessage Receive (TimeSpan serverWaitTime);
abstract member Receive : TimeSpan -> Microsoft.ServiceBus.Messaging.BrokeredMessage
override this.Receive : TimeSpan -> Microsoft.ServiceBus.Messaging.BrokeredMessage
Public Function Receive (serverWaitTime As TimeSpan) As BrokeredMessage
Parameters
- serverWaitTime
- TimeSpan
The time span the server waits for receiving a message before it times out.
Returns
The BrokeredMessage that represents the received message.
Exceptions
Thrown if the serverWaitTime
is negative.
Thrown when the subscription does not exist.
Thrown if the client entity has been closed or aborted.
Thrown if the operation exceeded the timeout value set via OperationTimeout.
Thrown if there is an authentication error.
Remarks
A Null can be return by this API if operation exceeded the timeout specified, or the operations succeeded but there are no more messages to be received.
Applies to
Azure SDK for .NET