IotHubBaseClient.SendTelemetryAsync Method

Reference

Definition

Namespace:: Microsoft.Azure.Devices.Client

Assembly:: Microsoft.Azure.Devices.Client.dll

Package:: Microsoft.Azure.Devices.Client v2.0.0-preview002

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sends a telemetry message to IoT hub.

public System.Threading.Tasks.Task SendTelemetryAsync (Microsoft.Azure.Devices.Client.TelemetryMessage message, System.Threading.CancellationToken cancellationToken = default);

member this.SendTelemetryAsync : Microsoft.Azure.Devices.Client.TelemetryMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SendTelemetryAsync (message As TelemetryMessage, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameters

message: TelemetryMessage

The message to send.

cancellationToken: CancellationToken

A cancellation token to cancel the operation.

Returns

Task

Exceptions

ArgumentNullException

Thrown when message is null.

OperationCanceledException

Thrown when the operation has been canceled.

InvalidOperationException

Thrown if the client instance is not opened already.

SocketException

Thrown if a socket error occurs.

WebSocketException

Thrown if an error occurs when performing an operation on a WebSocket connection.

IOException

Thrown if an I/O error occurs.

IotHubClientException

Thrown if an error occurs when communicating with IoT hub service.

Remarks

The client instance must be opened already.

In case of a transient issue, retrying the operation should work. In case of a non-transient issue, inspect the error details and take steps accordingly.

Applies to