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

TwinsClient.UpdateAsync 方法

参考

定义

命名空间:: Microsoft.Azure.Devices

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

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

重要

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

重载

UpdateAsync(IEnumerable<ClientTwin>, Boolean, CancellationToken)	更新以前在系统中创建的模块孪生列表的可变字段。
UpdateAsync(String, ClientTwin, Boolean, CancellationToken)	汇报模块孪生体可变字段。
UpdateAsync(String, String, ClientTwin, Boolean, CancellationToken)	汇报模块孪生体可变字段。

UpdateAsync(IEnumerable<ClientTwin>, Boolean, CancellationToken)

更新以前在系统中创建的模块孪生列表的可变字段。

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult> UpdateAsync (System.Collections.Generic.IEnumerable<Microsoft.Azure.Devices.ClientTwin> twins, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member UpdateAsync : seq<Microsoft.Azure.Devices.ClientTwin> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>
override this.UpdateAsync : seq<Microsoft.Azure.Devices.ClientTwin> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.BulkRegistryOperationResult>

Public Overridable Function UpdateAsync (twins As IEnumerable(Of ClientTwin), Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkRegistryOperationResult)

参数

twins: IEnumerable<ClientTwin>

包含更新字段的 ClientTwin列表。

onlyIfUnchanged: Boolean

如果为 false，则即使所提供的设备标识的 ETag 已过期，也会执行此操作。如果为 true，则如果提供的设备标识的 ETag 已过期，则操作将引发 IotHubServiceException PreconditionFailed 。可以使用检索 GetAsync(String, String, CancellationToken)最新的 ETag。

cancellationToken: CancellationToken

任务取消令牌。

Task<BulkRegistryOperationResult>

已更新模块孪生。

例外

ArgumentNullException

当提供的 twins 为 null 时。

ArgumentException

当提供的 twins 枚举为空时。

InvalidOperationException

当孪生体缺少预期的 ETag 时。

IotHubServiceException

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

HttpRequestException

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

OperationCanceledException

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

适用于

UpdateAsync(String, ClientTwin, Boolean, CancellationToken)

汇报模块孪生体可变字段。

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin> UpdateAsync (string deviceId, Microsoft.Azure.Devices.ClientTwin twinPatch, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member UpdateAsync : string * Microsoft.Azure.Devices.ClientTwin * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>
override this.UpdateAsync : string * Microsoft.Azure.Devices.ClientTwin * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.ClientTwin>

Public Overridable Function UpdateAsync (deviceId As String, twinPatch As ClientTwin, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ClientTwin)

参数

deviceId: String

设备 ID。

twinPatch: ClientTwin

包含更新字段的孪生体。

onlyIfUnchanged: Boolean

cancellationToken: CancellationToken

任务取消令牌。

Task<ClientTwin>

更新了设备孪生。

例外

ArgumentNullException

当提供的 deviceId 或 twinPatch 为 null 时。

ArgumentException

如果为 deviceId 空或空格。