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

ServiceClient 类

定义

命名空间:

Microsoft.Azure.Devices

程序集:

Microsoft.Azure.Devices.dll

包:

Microsoft.Azure.Devices v1.38.1

包含服务可用于将消息发送到设备的方法。

public class ServiceClient : IDisposable

type ServiceClient = class
    interface IDisposable

Public Class ServiceClient
Implements IDisposable

继承

Object

ServiceClient

实现

IDisposable

注解

有关详细信息，请参阅 https://github.com/Azure/azure-iot-sdk-csharp#iot-hub-service-sdk。

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

构造函数

ServiceClient()

创建 的实例，该实例 ServiceClient仅用于单元测试目的。 使用 CreateFromConnectionString 方法创建实例以使用客户端。

方法

CloseAsync()	关闭 ServiceClient 实例。 此调用是通过 AMQP 进行的。
Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	使用调用方根据需要提供和刷新的共享访问签名创建 ServiceClient。
Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	创建 ServiceClient，使用 Azure Active Directory (AAD) 中的标识进行身份验证。
CreateFromConnectionString(String, ServiceClientOptions)	从 IoT 中心连接字符串创建 ServiceClient。
CreateFromConnectionString(String, TransportType, ServiceClientOptions)	使用指定的传输类型从指定的 IoT 中心连接字符串创建 ServiceClient 的实例。
CreateFromConnectionString(String, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	使用指定的传输类型和传输设置从指定的 IoT 中心连接字符串创建 ServiceClient 的实例。
Dispose()	包含服务可用于将消息发送到设备的方法。
Dispose(Boolean)	释放非托管资源，并有选择性地释放托管资源。
GetFeedbackReceiver()	获取 ， FeedbackReceiver<T> 它可以为从 IoT 中心发送到设备/模块的消息传递确认。 此调用是通过 AMQP 进行的。 有关更多信息，请参见https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#message-feedback。
GetFileNotificationReceiver()	FileNotificationReceiver<T>获取可以传递文件上传操作通知的 。 此调用是通过 AMQP 进行的。 有关更多信息，请参见https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notifications。
GetServiceStatisticsAsync(CancellationToken)	获取 IoT 中心的服务统计信息。 此调用是通过 HTTP 进行的。
InvokeDeviceMethodAsync(String, CloudToDeviceMethod, CancellationToken)	以交互方式在设备上调用 方法。 cloudToDeviceMethod 中的超时时间增加了 15 秒，以考虑连接请求所花费的时间
InvokeDeviceMethodAsync(String, String, CloudToDeviceMethod, CancellationToken)	以交互方式调用模块上的方法。
OpenAsync()	打开 ServiceClient 实例。 此调用是通过 AMQP 进行的。
PurgeMessageQueueAsync(String, CancellationToken)	从设备队列中删除所有云到设备的消息。 此调用是通过 HTTP 进行的。
SendAsync(String, Message, Nullable<TimeSpan>)	将云到设备的消息发送到指定的设备。 此调用是通过 AMQP 进行的。
SendAsync(String, String, Message, Nullable<TimeSpan>)	将云到设备的消息发送到指定的模块。