DeviceClient.ReceiveAsync Methode

Definition

Namespace:

Microsoft.Azure.Devices.Client

Assemblys:

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

Pakete:

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

Überlädt

ReceiveAsync(CancellationToken)	Empfangen einer Nachricht von der Gerätewarteschlange mithilfe des Abbruchtokens. Nach der Behandlung einer empfangenen Nachricht sollte ein Client , AbandonAsync(Message, CancellationToken)oder RejectAsync(Message, CancellationToken)aufrufen CompleteAsync(Message, CancellationToken)und die Nachricht dann verwerfen.
ReceiveAsync(TimeSpan)	Empfangen einer Nachricht aus der Gerätewarteschlange mithilfe eines Timeouts. Nach der Behandlung einer empfangenen Nachricht sollte ein Client , AbandonAsync(Message, CancellationToken)oder RejectAsync(Message, CancellationToken)aufrufen CompleteAsync(Message, CancellationToken)und die Nachricht dann verwerfen.
ReceiveAsync()	Empfangen einer Nachricht aus der Gerätewarteschlange mithilfe des Standardtimeouts. Nach der Behandlung einer empfangenen Nachricht sollte ein Client , AbandonAsync(Message)oder RejectAsync(Message)aufrufen CompleteAsync(Message)und die Nachricht dann verwerfen.

ReceiveAsync(CancellationToken)

Empfangen einer Nachricht von der Gerätewarteschlange mithilfe des Abbruchtokens. Nach der Behandlung einer empfangenen Nachricht sollte ein Client , AbandonAsync(Message, CancellationToken)oder RejectAsync(Message, CancellationToken)aufrufen CompleteAsync(Message, CancellationToken)und die Nachricht dann verwerfen.

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)

Parameter

cancellationToken

CancellationToken

Ein Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Task<Message>

Die empfangene Nachricht oder NULL, wenn keine Nachricht vorhanden ist, bis das Abbruchtoken abgelaufen ist

Ausnahmen

OperationCanceledException

Wird ausgelöst, wenn der Vorgang abgebrochen wurde.

IotHubCommunicationException

Wird ausgelöst, wenn der Vorgang abgebrochen wurde. Die innere Ausnahme ist OperationCanceledException.

Hinweise

Sie können Nachrichten nicht über das MQTT-Protokoll ablehnen oder verwerfen. Weitere Details finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

ReceiveAsync(TimeSpan)

Empfangen einer Nachricht aus der Gerätewarteschlange mithilfe eines Timeouts. Nach der Behandlung einer empfangenen Nachricht sollte ein Client , AbandonAsync(Message, CancellationToken)oder RejectAsync(Message, CancellationToken)aufrufen CompleteAsync(Message, CancellationToken)und die Nachricht dann verwerfen.

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)

Parameter

timeout

TimeSpan

Gibt zurück

Task<Message>

Die empfangene Nachricht oder NULL, wenn keine Nachricht vorhanden ist, bis die angegebene Zeit verstrichen ist.

Hinweise

Sie können Nachrichten nicht über das MQTT-Protokoll ablehnen oder verwerfen. Weitere Details finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#the-cloud-to-device-message-life-cycle.

ReceiveAsync()

Empfangen einer Nachricht aus der Gerätewarteschlange mithilfe des Standardtimeouts. Nach der Behandlung einer empfangenen Nachricht sollte ein Client , AbandonAsync(Message)oder RejectAsync(Message)aufrufen CompleteAsync(Message)und die Nachricht dann verwerfen.

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)

Gibt zurück

Task<Message>

Die Empfangsnachricht oder NULL, wenn bis zum Standardtimeout keine Nachricht vorhanden ist

Hinweise

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