DeviceClient.ReceiveAsync Método

Definição

Namespace:

Microsoft.Azure.Devices.Client

Assemblies:

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

Pacotes:

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

Sobrecargas

ReceiveAsync(CancellationToken)	Receba uma mensagem da fila do dispositivo usando o token de cancelamento. Depois de lidar com uma mensagem recebida, um cliente deve chamar CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken)e, em seguida, descartar a mensagem.
ReceiveAsync(TimeSpan)	Receba uma mensagem da fila do dispositivo usando um tempo limite. Depois de lidar com uma mensagem recebida, um cliente deve chamar CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken)e, em seguida, descartar a mensagem.
ReceiveAsync()	Receba uma mensagem da fila do dispositivo usando o tempo limite padrão. Depois de lidar com uma mensagem recebida, um cliente deve chamar CompleteAsync(Message), AbandonAsync(Message)ou RejectAsync(Message)e, em seguida, descartar a mensagem.

ReceiveAsync(CancellationToken)

Receba uma mensagem da fila do dispositivo usando o token de cancelamento. Depois de lidar com uma mensagem recebida, um cliente deve chamar CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken)e, em seguida, descartar a mensagem.

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)

Parâmetros

cancellationToken

CancellationToken

Um token de cancelamento para cancelar a operação.

Retornos

Task<Message>

A mensagem recebida ou nula se não houver nenhuma mensagem até que o token de cancelamento tenha expirado

Exceções

OperationCanceledException

Gerada quando a operação foi cancelada.

IotHubCommunicationException

Gerada quando a operação foi cancelada. A exceção interna será OperationCanceledException.

Comentários

Você não pode rejeitar ou abandonar mensagens pelo protocolo MQTT. Para obter mais detalhes, confira https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

ReceiveAsync(TimeSpan)

Receba uma mensagem da fila do dispositivo usando um tempo limite. Depois de lidar com uma mensagem recebida, um cliente deve chamar CompleteAsync(Message, CancellationToken), AbandonAsync(Message, CancellationToken)ou RejectAsync(Message, CancellationToken)e, em seguida, descartar a mensagem.

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)

Parâmetros

timeout

TimeSpan

Retornos

Task<Message>

A mensagem recebida ou nula se não houver nenhuma mensagem até que o tempo especificado tenha decorrido.

Comentários

Você não pode rejeitar ou abandonar mensagens pelo protocolo MQTT. Para obter mais detalhes, confira https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

ReceiveAsync()

Receba uma mensagem da fila do dispositivo usando o tempo limite padrão. Depois de lidar com uma mensagem recebida, um cliente deve chamar CompleteAsync(Message), AbandonAsync(Message)ou RejectAsync(Message)e, em seguida, descartar a mensagem.

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)

Retornos

Task<Message>

A mensagem de recebimento ou nulo se não houver nenhuma mensagem até o tempo limite padrão

Comentários

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