ProvisioningDeviceClient.RegisterAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Devices.Provisioning.Client

Assembly:

Microsoft.Azure.Devices.Provisioning.Client.dll

Paquet:

Microsoft.Azure.Devices.Provisioning.Client v1.19.1

Surcharges

RegisterAsync(CancellationToken)	Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.
RegisterAsync(TimeSpan)	Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.
RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)	Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.
RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)	Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.

RegisterAsync(CancellationToken)

Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (System.Threading.CancellationToken cancellationToken = default);

member this.RegisterAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>

Public Function RegisterAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DeviceRegistrationResult)

Paramètres

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<DeviceRegistrationResult>

Résultat de l’inscription.

Remarques

Étant donné que la bibliothèque AMQP utilisée par cette bibliothèque n’accepte pas les jetons d’annulation, le jeton d’annulation fourni sera vérifié uniquement entre les opérations AMQP et non pendant. Pour avoir un délai d’attente pour cette opération qui est vérifié pendant les opérations AMQP (par exemple, l’ouverture de la connexion), vous devez utiliser RegisterAsync(TimeSpan) à la place. À cet égard, les connexions MQTT et HTTPS n’ont pas le même comportement que les connexions AMQP. Les connexions MQTT et HTTPS case activée ce jeton d’annulation pour l’annulation pendant leurs opérations au niveau du protocole.

RegisterAsync(TimeSpan)

Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (TimeSpan timeout);

member this.RegisterAsync : TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>

Public Function RegisterAsync (timeout As TimeSpan) As Task(Of DeviceRegistrationResult)

Paramètres

timeout

TimeSpan

Durée maximale pendant laquelle cette opération peut s’exécuter avant l’expiration du délai d’attente.

Retours

Task<DeviceRegistrationResult>

Résultat de l’inscription.

Remarques

Étant donné que la bibliothèque AMQP utilisée par cette bibliothèque n’accepte pas les jetons d’annulation, cette surcharge et RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan) sont les seules surcharges pour cette méthode qui permettent de respecter un délai d’expiration spécifié au milieu d’une opération AMQP telle que l’ouverture de la connexion AMQP. Toutefois, les connexions MQTT et HTTPS ne partagent pas cette même limitation.

RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)

Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData data, System.Threading.CancellationToken cancellationToken = default);

member this.RegisterAsync : Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>

Public Function RegisterAsync (data As ProvisioningRegistrationAdditionalData, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DeviceRegistrationResult)

Paramètres

data

ProvisioningRegistrationAdditionalData

Données supplémentaires facultatives transmises au webhook de stratégie d’allocation personnalisée si un webhook de stratégie d’allocation personnalisé est configuré pour cette inscription.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<DeviceRegistrationResult>

Résultat de l’inscription.

Remarques

Étant donné que la bibliothèque AMQP utilisée par cette bibliothèque n’accepte pas les jetons d’annulation, le jeton d’annulation fourni sera vérifié uniquement entre les opérations AMQP et non pendant. Pour avoir un délai d’attente pour cette opération qui est vérifié pendant les opérations AMQP (telles que l’ouverture de la connexion), vous devez utiliser cette surcharge à la place. À cet égard, les connexions MQTT et HTTPS n’ont pas le même comportement que les connexions AMQP. Les connexions MQTT et HTTPS case activée ce jeton d’annulation pour l’annulation pendant leurs opérations au niveau du protocole.

RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)

Inscrit l’appareil actuel à l’aide du service Device Provisioning et l’affecte à un hub IoT.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData data, TimeSpan timeout);

member this.RegisterAsync : Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData * TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>

Public Function RegisterAsync (data As ProvisioningRegistrationAdditionalData, timeout As TimeSpan) As Task(Of DeviceRegistrationResult)

Paramètres

data

ProvisioningRegistrationAdditionalData

Données supplémentaires facultatives transmises au webhook de stratégie d’allocation personnalisée si un webhook de stratégie d’allocation personnalisé est configuré pour cette inscription.

timeout

TimeSpan

Durée maximale pendant laquelle cette opération peut s’exécuter avant l’expiration du délai d’attente.

Retours

Task<DeviceRegistrationResult>

Résultat de l’inscription.

Remarques

Étant donné que la bibliothèque AMQP utilisée par cette bibliothèque n’accepte pas les jetons d’annulation, cette surcharge et RegisterAsync(TimeSpan) sont les seules surcharges pour cette méthode qui permettent de respecter un délai d’expiration spécifié au milieu d’une opération AMQP telle que l’ouverture de la connexion AMQP. Toutefois, les connexions MQTT et HTTPS ne partagent pas cette même limitation.