DeviceClient.ReceiveAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Devices.Client

Assemblys:

Microsoft.Azure.Devices.Client.dll, Microsoft.Azure.Devices.Client.PCL.dll

Paquets:

Microsoft.Azure.Devices.Client v1.41.2, Microsoft.Azure.Devices.Client.PCL v1.0.16

Surcharges

ReceiveAsync(CancellationToken)	Recevez un message de la file d’attente de l’appareil à l’aide du jeton d’annulation. Après avoir géré un message reçu, un client doit appeler CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken), puis supprimer le message.
ReceiveAsync(TimeSpan)	Recevez un message de la file d’attente de l’appareil à l’aide d’un délai d’expiration. Après avoir géré un message reçu, un client doit appeler CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken), puis supprimer le message.
ReceiveAsync()	Recevez un message de la file d’attente de l’appareil à l’aide du délai d’expiration par défaut. Après avoir géré un message reçu, un client doit appeler CompleteAsync(Message), AbandonAsync(Message)ou RejectAsync(Message), puis supprimer le message.

ReceiveAsync(CancellationToken)

Recevez un message de la file d’attente de l’appareil à l’aide du jeton d’annulation. Après avoir géré un message reçu, un client doit appeler CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken), puis supprimer le message.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Client.Message> ReceiveAsync (System.Threading.CancellationToken cancellationToken);

member this.ReceiveAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Client.Message>

Public Function ReceiveAsync (cancellationToken As CancellationToken) As Task(Of Message)

Paramètres

cancellationToken

CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task<Message>

Message reçu ou null s’il n’y avait aucun message tant que le jeton d’annulation n’a pas expiré

Exceptions

OperationCanceledException

Levée lorsque l’opération a été annulée.

IotHubCommunicationException

Levée lorsque l’opération a été annulée. L’exception interne sera OperationCanceledException.

Remarques

Vous ne pouvez pas rejeter ou abandonner des messages via le protocole MQTT. Pour plus d'informations, consultez https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

ReceiveAsync(TimeSpan)

Recevez un message de la file d’attente de l’appareil à l’aide d’un délai d’expiration. Après avoir géré un message reçu, un client doit appeler CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken), puis supprimer le message.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Client.Message> ReceiveAsync (TimeSpan timeout);

member this.ReceiveAsync : TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Client.Message>

Public Function ReceiveAsync (timeout As TimeSpan) As Task(Of Message)

Paramètres

timeout

TimeSpan

Retours

Task<Message>

Message reçu ou null s’il n’y avait aucun message tant que le temps spécifié n’est pas écoulé.

Remarques

Vous ne pouvez pas rejeter ou abandonner des messages via le protocole MQTT. Pour plus d'informations, consultez https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

ReceiveAsync()

Recevez un message de la file d’attente de l’appareil à l’aide du délai d’expiration par défaut. Après avoir géré un message reçu, un client doit appeler CompleteAsync(Message), AbandonAsync(Message)ou RejectAsync(Message), puis supprimer le message.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Client.Message> ReceiveAsync ();

member this.ReceiveAsync : unit -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Client.Message>

Public Function ReceiveAsync () As Task(Of Message)

Retours

Task<Message>

Message de réception ou null s’il n’y avait aucun message jusqu’au délai d’expiration par défaut

Remarques

https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.