ServiceClient Klasse

Referenz

Definition

Namespace:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

Paket:: Microsoft.Azure.Devices v1.38.1

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Enthält Methoden, mit denen Dienste Nachrichten an Geräte senden können.

public class ServiceClient : IDisposable

type ServiceClient = class
    interface IDisposable

Public Class ServiceClient
Implements IDisposable

Vererbung: Object
ServiceClient

Implementiert: IDisposable

Hinweise

Weitere Informationen finden Sie unter https://github.com/Azure/azure-iot-sdk-csharp#iot-hub-service-sdk.

Dieser Client erstellt lange Instanzen von HttpClient , die an den URI des angegebenen IoT-Hubs gebunden sind, konfiguriert alle Proxyeinstellungen und das Timeout der Verbindungsleasing. Aus diesem Grund sind die Instanzen nicht statisch, und eine Anwendung, die diesen Client verwendet, sollte sie für alle Zwecke erstellen und speichern. Wiederholte Erstellung kann zu Einer Socketauslastung führen.

Konstruktoren

ServiceClient()

Erstellt eine instance von , die ServiceClientnur für Komponententests bereitgestellt wird. Verwenden Sie die CreateFromConnectionString-Methode, um eine instance für die Verwendung des Clients zu erstellen.

Methoden

CloseAsync()	Schließen Sie die ServiceClient-instance. Dieser Aufruf erfolgt über AMQP.
Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	Erstellt ServiceClient mithilfe einer Shared Access Signature, die vom Aufrufer bereitgestellt und aktualisiert wird.
Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	Erstellt ServiceClient und authentifiziert sich mithilfe einer Identität in Azure Active Directory (AAD).
CreateFromConnectionString(String, ServiceClientOptions)	Erstellt ServiceClient aus einer IoT Hub-Verbindungszeichenfolge.
CreateFromConnectionString(String, TransportType, ServiceClientOptions)	Erstellen Sie eine instance von ServiceClient aus der angegebenen IoT Hub-Verbindungszeichenfolge unter Verwendung des angegebenen Transporttyps.
CreateFromConnectionString(String, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	Erstellen Sie eine instance von ServiceClient aus der angegebenen IoT Hub-Verbindungszeichenfolge mithilfe der angegebenen Transporttyp- und Transporteinstellungen.
Dispose()	Enthält Methoden, mit denen Dienste Nachrichten an Geräte senden können.
Dispose(Boolean)	Gibt nicht verwaltete und optional verwaltete Ressourcen frei.
GetFeedbackReceiver()	Rufen Sie die ab, die FeedbackReceiver<T> Bestätigungen für Nachrichten übermitteln kann, die von IoT Hub an ein Gerät/Modul gesendet werden. Dieser Aufruf erfolgt über AMQP. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d#message-feedback.
GetFileNotificationReceiver()	Rufen Sie die ab, die FileNotificationReceiver<T> Benachrichtigungen für Dateiuploadvorgänge übermitteln kann. Dieser Aufruf erfolgt über AMQP. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notifications.
GetServiceStatisticsAsync(CancellationToken)	Ruft Dienststatistiken für den IoT Hub ab. Dieser Aufruf erfolgt über HTTP.
InvokeDeviceMethodAsync(String, CloudToDeviceMethod, CancellationToken)	Ruft interaktiv eine Methode auf einem Gerät auf. Zusätzliche 15s werden zum Timeout in cloudToDeviceMethod hinzugefügt, um die Zeit zu berücksichtigen, die zum Verknüpfen einer Anforderung erforderlich ist.
InvokeDeviceMethodAsync(String, String, CloudToDeviceMethod, CancellationToken)	Ruft interaktiv eine Methode für ein Modul auf.
OpenAsync()	Öffnen Sie den ServiceClient-instance. Dieser Aufruf erfolgt über AMQP.
PurgeMessageQueueAsync(String, CancellationToken)	Entfernt alle C2D-Nachrichten aus der Warteschlange eines Geräts. Dieser Aufruf erfolgt über HTTP.
SendAsync(String, Message, Nullable<TimeSpan>)	Senden sie eine Cloud-zu-Gerät-Nachricht an das angegebene Gerät. Dieser Aufruf erfolgt über AMQP.
SendAsync(String, String, Message, Nullable<TimeSpan>)	Senden sie eine Cloud-zu-Gerät-Nachricht an das angegebene Modul.

Gilt für:

Freigeben über