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

ConfigurationsClient.GetAsync 方法

参考

定义

命名空间:: Microsoft.Azure.Devices

程序集:: Microsoft.Azure.Devices.dll

包:: Microsoft.Azure.Devices v2.0.0-preview002

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

GetAsync(Int32, CancellationToken)	从每个 IoT 中心分区检索指定数量的配置。结果不排序。
GetAsync(String, CancellationToken)	检索指定的配置对象。

GetAsync(Int32, CancellationToken)

从每个 IoT 中心分区检索指定数量的配置。结果不排序。

public virtual System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.Azure.Devices.Configuration>> GetAsync(int maxCount, System.Threading.CancellationToken cancellationToken = default);

abstract member GetAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<seq<Microsoft.Azure.Devices.Configuration>>
override this.GetAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<seq<Microsoft.Azure.Devices.Configuration>>

Public Overridable Function GetAsync (maxCount As Integer, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IEnumerable(Of Configuration))

参数

maxCount: Int32

cancellationToken: CancellationToken

Task<IEnumerable<Configuration>>

配置列表。

例外

ArgumentException

如果值小于零， maxCount 则引发。

IotHubServiceException

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

HttpRequestException

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

OperationCanceledException

如果提供的 cancellationToken 已请求取消。

适用于

GetAsync(String, CancellationToken)

检索指定的配置对象。

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

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

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

参数

configurationId: String

要检索的配置的 ID。

cancellationToken: CancellationToken

允许取消操作的标记。

Task<Configuration>

配置对象。

例外

ArgumentNullException

当提供的 configurationId 为 null 时引发。