你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ProvisioningDeviceClient.RegisterAsync 方法

定义

命名空间:

Microsoft.Azure.Devices.Provisioning.Client

程序集:

Microsoft.Azure.Devices.Provisioning.Client.dll

包:

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

重载

RegisterAsync(CancellationToken)	使用设备预配服务注册当前设备，并将其分配给 IoT 中心。
RegisterAsync(TimeSpan)	使用设备预配服务注册当前设备，并将其分配给 IoT 中心。
RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)	使用设备预配服务注册当前设备，并将其分配给 IoT 中心。
RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)	使用设备预配服务注册当前设备，并将其分配给 IoT 中心。

RegisterAsync(CancellationToken)

使用设备预配服务注册当前设备，并将其分配给 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)

参数

cancellationToken

CancellationToken

取消标记。

返回

Task<DeviceRegistrationResult>

注册结果。

注解

由于此库使用的 AMQP 库使用不接受取消令牌，因此只会在 AMQP 操作之间（而不是期间）检查提供的取消令牌。 若要在 AMQP 操作 (（例如打开连接) ）期间检查此操作的超时，必须改用 RegisterAsync(TimeSpan) 。 在这方面，MQTT 和 HTTPS 连接的行为与 AMQP 连接不同。 MQTT 和 HTTPS 连接将在协议级别操作期间检查取消此取消令牌。

RegisterAsync(TimeSpan)

使用设备预配服务注册当前设备，并将其分配给 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)

参数

timeout

TimeSpan

允许此操作在超时前运行的最长时间。

返回

Task<DeviceRegistrationResult>

注册结果。

注解

由于此库使用的 AMQP 库使用不接受取消令牌，因此此重载和 RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan) 是此方法的唯一重载，允许在 AMQP 操作（例如打开 AMQP 连接）中遵循指定的超时。 不过，MQTT 和 HTTPS 连接没有相同的限制。

RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)

使用设备预配服务注册当前设备，并将其分配给 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)

参数

data

ProvisioningRegistrationAdditionalData

如果为此注册设置了自定义分配策略 Webhook，则传递给自定义分配策略 Webhook 的可选附加数据。

cancellationToken

CancellationToken

取消标记。

返回

Task<DeviceRegistrationResult>

注册结果。

注解

由于此库使用的 AMQP 库使用不接受取消令牌，因此只会在 AMQP 操作之间（而不是期间）检查提供的取消令牌。 若要在 AMQP 操作 (（例如打开连接) ）期间检查此操作的超时，必须改用 此重载 。 在这方面，MQTT 和 HTTPS 连接的行为与 AMQP 连接不同。 MQTT 和 HTTPS 连接将在协议级别操作期间检查取消此取消令牌。

RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)

使用设备预配服务注册当前设备，并将其分配给 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)

参数

data

ProvisioningRegistrationAdditionalData

如果为此注册设置了自定义分配策略 Webhook，则传递给自定义分配策略 Webhook 的可选附加数据。

timeout

TimeSpan

允许此操作在超时前运行的最长时间。

返回

Task<DeviceRegistrationResult>

注册结果。

注解

由于此库使用的 AMQP 库使用不接受取消令牌，因此此重载和 RegisterAsync(TimeSpan) 是此方法的唯一重载，允许在 AMQP 操作（例如打开 AMQP 连接）中遵循指定的超时。 不过，MQTT 和 HTTPS 连接没有相同的限制。