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

IotHubServiceClient 类

定义

命名空间:

Microsoft.Azure.Devices

程序集:

Microsoft.Azure.Devices.dll

包:

Microsoft.Azure.Devices v2.0.0-preview002

用于向 IoT 中心发出服务请求的客户端。 此客户端包含 IoT 中心内各种功能集的子客户端，包括管理设备/模块标识、获取/设置设备/模块的孪生体、在设备/模块上调用直接方法等。

public class IotHubServiceClient : IDisposable

type IotHubServiceClient = class
    interface IDisposable

Public Class IotHubServiceClient
Implements IDisposable

继承

Object

IotHubServiceClient

实现

IDisposable

注解

此客户端是 IDisposable ，但用户不负责释放此客户端中的子客户端。

此客户端创建一个生存期长的 实例，该实例 HttpClient 绑定到使用提供的任何代理设置指定和配置的 IoT 中心的 URI。 因此，实例不是静态的，使用此客户端的应用程序应创建并保存它以供所有使用。 重复创建可能会导致 套接字耗尽。

构造函数

IotHubServiceClient()	创建此类的实例。 仅供单元测试使用。
IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)	创建此类的实例，该实例使用调用方根据需要提供和刷新的共享访问签名对服务请求进行身份验证。
IotHubServiceClient(String, IotHubServiceClientOptions)	创建此类的实例，该实例使用 IoT 中心连接字符串对服务请求进行身份验证。
IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)	创建此类的实例，该实例使用 Azure Active Directory (AAD) 中的标识对服务请求进行身份验证。

属性

Configurations	的 IotHubServiceClient 子客户端，用于处理配置获取/添加/设置/删除配置。
Devices	所有设备注册表操作的子客户端，包括获取/添加/设置/删除设备标识、获取设备上的模块以及获取设备注册表统计信息。
DigitalTwins	的 IotHubServiceClient 子客户端处理所有数字孪生体操作，包括获取数字孪生体、更新数字孪生体和在数字孪生体上调用命令。
DirectMethods	的 IotHubServiceClient 子客户端，用于在 IoT 中心的设备和模块上直接调用直接方法。
FileUploadNotifications	用于接收文件上传通知的 子客户端 IotHubServiceClient 。
MessageFeedback	用于接收云到设备消息反馈的 子客户端 IotHubServiceClient 。
Messages	用于 IotHubServiceClient 发送云到设备和云到模块消息的 子客户端。
Modules	的 IotHubServiceClient 子客户端，用于处理所有模块注册表操作，包括获取/添加/设置/删除模块标识。
Query	的 IotHubServiceClient 子客户端，用于使用类似于 SQL 的语法执行查询。
ScheduledJobs	计划作业管理的 子 IotHubServiceClient 客户端。
Twins	的 IotHubServiceClient 子客户端负责获取、更新和替换设备和模块孪生。

方法

Dispose()

释放此客户端及其拥有的所有可释放资源。 这包括由此客户端创建或提供给此客户端的任何 HTTP 客户端。