QueueClient.Receive Méthode

Définition

Espace de noms:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Paquet:

WindowsAzure.ServiceBus v6.2.2

Surcharges

Receive()	Reçoit un message à l’aide de Microsoft.ServiceBus.Messaging.QueueClient.InternalReceiver.
Receive(Int64)	Reçoit un message différé à l’aide de Microsoft.ServiceBus.Messaging.QueueClient.InternalReceiver. Cette méthode fonctionne uniquement pour les messages différés, et non pour les messages normaux.
Receive(TimeSpan)	Reçoit un message à l’aide de Microsoft.ServiceBus.Messaging.QueueClient.InternalReceiver.

Receive()

Reçoit un message à l’aide de Microsoft.ServiceBus.Messaging.QueueClient.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

Retours

BrokeredMessage

BrokeredMessage qui représente le message reçu. Si aucun message n’est disponible à recevoir, la méthode retourne NULL et vous pouvez réessayer l’opération ultérieurement.

Exceptions

OperationCanceledException

Levée si l’entité cliente a été fermée ou abandonnée.

TimeoutException

Levée si l’opération de réception du message expire.

UnauthorizedAccessException

Levée si une erreur d’E/S ou de sécurité se produit.

MessagingEntityNotFoundException

Levée si l’entité de messagerie associée à l’opération n’existe pas ou si elle a été supprimée.

MessagingException

Levée si le code utilisateur a effectué des opérations inattendues ou si la passerelle Service Bus est en panne. Vérifiez l’erreur réelle dans le message d’exception.

Remarques

Une valeur Null peut être retournée par cette API si l’opération a dépassé le délai d’attente spécifié ou si les opérations ont réussi, mais qu’il n’y a plus de messages à recevoir.

Receive(Int64)

Reçoit un message différé à l’aide de Microsoft.ServiceBus.Messaging.QueueClient.InternalReceiver. Cette méthode fonctionne uniquement pour les messages différés, et non pour les messages normaux.

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

Paramètres

sequenceNumber

Int64

Numéro de séquence du message différé à recevoir.

Retours

BrokeredMessage

BrokeredMessage qui représente le message reçu. Si aucun message n’est disponible à recevoir, la méthode retourne NULL et vous pouvez réessayer l’opération ultérieurement.

Exceptions

OperationCanceledException

Levée si l’entité cliente a été fermée ou abandonnée.

Remarques

Une valeur Null peut être retournée par cette API si l’opération a dépassé le délai d’attente spécifié, ou si les opérations ont réussi, mais que le message avec le sequenceNumber demandé ne peut pas être trouvé.

Receive(TimeSpan)

Reçoit un message à l’aide de Microsoft.ServiceBus.Messaging.QueueClient.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

Paramètres

serverWaitTime

TimeSpan

Intervalle de temps pendant lequel le serveur attend la réception d’un message avant d’expirer.

Retours

BrokeredMessage

BrokeredMessage qui représente le message reçu. Si aucun message n’est disponible à recevoir, la méthode retourne NULL et vous pouvez réessayer l’opération ultérieurement.

Exceptions

ArgumentOutOfRangeException

Levée si est serverWaitTime négatif.

TimeoutException

Levée si l’opération de réception du message expire.

OperationCanceledException

Levée si l’entité cliente a été fermée ou abandonnée.

UnauthorizedAccessException

Levée si une erreur d’E/S ou de sécurité se produit.

MessagingEntityNotFoundException

Levée si l’entité de messagerie associée à l’opération n’existe pas ou si elle a été supprimée.

MessagingException

Levée si le code utilisateur a effectué des opérations inattendues ou si la passerelle Service Bus est en panne. Vérifiez l’erreur réelle dans le message d’exception.

Remarques

Une valeur Null peut être retournée par cette API si l’opération a dépassé le délai d’attente spécifié ou si les opérations ont réussi, mais qu’il n’y a plus de messages à recevoir.