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

DevicesClient.GetAsync(String, CancellationToken) 方法

定义

命名空间:

Microsoft.Azure.Devices

程序集:

Microsoft.Azure.Devices.dll

包:

Microsoft.Azure.Devices v2.0.0-preview002

按 ID 获取设备标识。

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device> GetAsync (string deviceId, System.Threading.CancellationToken cancellationToken = default);

abstract member GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>
override this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Device>

Public Overridable Function GetAsync (deviceId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Device)

参数

deviceId

String

要检索的设备标识的唯一标识符。

cancellationToken

CancellationToken

允许取消操作的令牌。

返回

Task<Device>

检索到的设备标识。

例外

ArgumentNullException

当提供的设备 ID 为 null 时。

ArgumentException

当提供的设备 ID 为空或空格时。

IotHubServiceException

如果 IoT 中心使用不成功的状态代码响应了请求。 例如，如果提供的请求受到限制， IotHubServiceException 则会引发 with ThrottlingException 。 有关可能的错误情况的完整列表，请参阅 IotHubServiceErrorCode。

HttpRequestException

如果 HTTP 请求因网络连接、DNS 故障或服务器证书验证等基础问题而失败。

OperationCanceledException

如果提供的取消令牌已请求取消。