QueueClient.Receive Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 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
Levée si l’entité cliente a été fermée ou abandonnée.
Levée si l’opération de réception du message expire.
Levée si une erreur d’E/S ou de sécurité se produit.
Levée si l’entité de messagerie associée à l’opération n’existe pas ou si elle a été supprimée.
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.
S’applique à
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 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
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é.
S’applique à
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 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
Levée si est serverWaitTime
négatif.
Levée si l’opération de réception du message expire.
Levée si l’entité cliente a été fermée ou abandonnée.
Levée si une erreur d’E/S ou de sécurité se produit.
Levée si l’entité de messagerie associée à l’opération n’existe pas ou si elle a été supprimée.
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.
S’applique à
Azure SDK for .NET