ProvisioningDeviceClient.RegisterAsync Método

Definição

Namespace:

Microsoft.Azure.Devices.Provisioning.Client

Assembly:

Microsoft.Azure.Devices.Provisioning.Client.dll

Pacote:

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

Sobrecargas

RegisterAsync(CancellationToken)	Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um Hub IoT.
RegisterAsync(TimeSpan)	Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um Hub IoT.
RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)	Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um Hub IoT.
RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)	Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um Hub IoT.

RegisterAsync(CancellationToken)

Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um 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)

Parâmetros

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<DeviceRegistrationResult>

O resultado do registro.

Comentários

Devido à biblioteca AMQP usada por essa biblioteca não aceitar tokens de cancelamento, o token de cancelamento fornecido só será verificado quanto ao cancelamento entre operações AMQP e não durante. Para ter um tempo limite para essa operação que é verificado durante operações AMQP (como abrir a conexão), você deve usar RegisterAsync(TimeSpan) em vez disso. As conexões MQTT e HTTPS não têm o mesmo comportamento que as conexões AMQP nesse sentido. As conexões MQTT e HTTPS marcar esse token de cancelamento para cancelamento durante suas operações de nível de protocolo.

RegisterAsync(TimeSpan)

Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um 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)

Parâmetros

timeout

TimeSpan

A quantidade máxima de tempo para permitir que essa operação seja executada antes de atingir o tempo limite.

Retornos

Task<DeviceRegistrationResult>

O resultado do registro.

Comentários

Devido à biblioteca AMQP usada por essa biblioteca usar não aceitar tokens de cancelamento, essa sobrecarga e RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan) são as únicas sobrecargas para esse método que permitem que um tempo limite especificado seja respeitado no meio de uma operação AMQP, como abrir a conexão AMQP. No entanto, as conexões MQTT e HTTPS não compartilham essa mesma limitação.

RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)

Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um 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)

Parâmetros

data

ProvisioningRegistrationAdditionalData

Os dados adicionais opcionais que são passados para o webhook de política de alocação personalizada se um webhook de política de alocação personalizado estiver configurado para esse registro.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<DeviceRegistrationResult>

O resultado do registro.

Comentários

Devido à biblioteca AMQP usada por essa biblioteca não aceitar tokens de cancelamento, o token de cancelamento fornecido só será verificado quanto ao cancelamento entre operações AMQP e não durante. Para ter um tempo limite para essa operação que é verificado durante operações AMQP (como abrir a conexão), você deve usar essa sobrecarga . As conexões MQTT e HTTPS não têm o mesmo comportamento que as conexões AMQP nesse sentido. As conexões MQTT e HTTPS marcar esse token de cancelamento para cancelamento durante suas operações de nível de protocolo.

RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)

Registra o dispositivo atual usando o Serviço de Provisionamento de Dispositivos e o atribui a um 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)

Parâmetros

data

ProvisioningRegistrationAdditionalData

Os dados adicionais opcionais que são passados para o webhook de política de alocação personalizada se um webhook de política de alocação personalizado estiver configurado para esse registro.

timeout

TimeSpan

A quantidade máxima de tempo para permitir que essa operação seja executada antes de atingir o tempo limite.

Retornos

Task<DeviceRegistrationResult>

O resultado do registro.

Comentários

Devido à biblioteca AMQP usada por essa biblioteca usar não aceitar tokens de cancelamento, essa sobrecarga e RegisterAsync(TimeSpan) são as únicas sobrecargas para esse método que permitem que um tempo limite especificado seja respeitado no meio de uma operação AMQP, como abrir a conexão AMQP. No entanto, as conexões MQTT e HTTPS não compartilham essa mesma limitação.