IotHubServiceClient Konstruktoren

Definition

Namespace:

Microsoft.Azure.Devices

Assembly:

Microsoft.Azure.Devices.dll

Paket:

Microsoft.Azure.Devices v2.0.0-preview002

Überlädt

IotHubServiceClient()	Erstellt eine Instanz dieser Klasse. Wird nur zu Komponententests bereitgestellt.
IotHubServiceClient(String, IotHubServiceClientOptions)	Erstellen Sie eine instance dieser Klasse, die Dienstanforderungen mithilfe einer IoT Hub-Verbindungszeichenfolge authentifiziert.
IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)	Erstellen Sie eine instance dieser Klasse, die Dienstanforderungen mit einer Shared Access Signature authentifiziert, die vom Aufrufer bereitgestellt und aktualisiert wird.
IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)	Erstellen Sie eine instance dieser Klasse, die Dienstanforderungen mithilfe einer Identität in Azure Active Directory (AAD) authentifiziert.

IotHubServiceClient()

Erstellt eine Instanz dieser Klasse. Wird nur zu Komponententests bereitgestellt.

protected IotHubServiceClient ();

Protected Sub New ()

IotHubServiceClient(String, IotHubServiceClientOptions)

Erstellen Sie eine instance dieser Klasse, die Dienstanforderungen mithilfe einer IoT Hub-Verbindungszeichenfolge authentifiziert.

public IotHubServiceClient (string connectionString, Microsoft.Azure.Devices.IotHubServiceClientOptions options = default);

new Microsoft.Azure.Devices.IotHubServiceClient : string * Microsoft.Azure.Devices.IotHubServiceClientOptions -> Microsoft.Azure.Devices.IotHubServiceClient

Public Sub New (connectionString As String, Optional options As IotHubServiceClientOptions = Nothing)

Parameter

connectionString

String

Die IoT Hub-Verbindungszeichenfolge.

options

IotHubServiceClientOptions

Die optionalen Clienteinstellungen.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn die angegebene Verbindungszeichenfolge NULL ist.

ArgumentException

Wird ausgelöst, wenn die bereitgestellte Verbindungszeichenfolge leer oder leer ist.

IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)

Erstellen Sie eine instance dieser Klasse, die Dienstanforderungen mit einer Shared Access Signature authentifiziert, die vom Aufrufer bereitgestellt und aktualisiert wird.

public IotHubServiceClient (string hostName, Azure.AzureSasCredential credential, Microsoft.Azure.Devices.IotHubServiceClientOptions options = default);

new Microsoft.Azure.Devices.IotHubServiceClient : string * Azure.AzureSasCredential * Microsoft.Azure.Devices.IotHubServiceClientOptions -> Microsoft.Azure.Devices.IotHubServiceClient

Public Sub New (hostName As String, credential As AzureSasCredential, Optional options As IotHubServiceClientOptions = Nothing)

Parameter

hostName

String

IoT Hub-Hostname. Für instance: "my-iot-hub.azure-devices.net".

credential

AzureSasCredential

Anmeldeinformationen, die ein SAS-Token für die Authentifizierung bei IoT Hub generieren. Siehe AzureSasCredential.

options

IotHubServiceClientOptions

Die optionalen Clienteinstellungen.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn das angegebene hostName oder credential NULL ist.

ArgumentException

Wird ausgelöst, wenn die bereitgestellte hostName leer oder leer ist.

Hinweise

Benutzer möchten möglicherweise ihre eigenen SAS-Token (Shared Access Signature) erstellen, anstatt den freigegebenen Schlüssel an das SDK zu übergeben und das Signieren und Erneuern zu verwalten. Das AzureSasCredential -Objekt gewährt dem SDK Zugriff auf das SAS-Token, während der Aufrufer es nach Bedarf mithilfe der Update(String) -Methode aktualisieren kann.

IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)

Erstellen Sie eine instance dieser Klasse, die Dienstanforderungen mithilfe einer Identität in Azure Active Directory (AAD) authentifiziert.

public IotHubServiceClient (string hostName, Azure.Core.TokenCredential credential, Microsoft.Azure.Devices.IotHubServiceClientOptions options = default);

new Microsoft.Azure.Devices.IotHubServiceClient : string * Azure.Core.TokenCredential * Microsoft.Azure.Devices.IotHubServiceClientOptions -> Microsoft.Azure.Devices.IotHubServiceClient

Public Sub New (hostName As String, credential As TokenCredential, Optional options As IotHubServiceClientOptions = Nothing)

Parameter

hostName

String

IoT Hub-Hostname. Für instance: "my-iot-hub.azure-devices.net".

credential

TokenCredential

Azure Active Directory-Anmeldeinformationen (AAD) für die Authentifizierung bei IoT Hub.

options

IotHubServiceClientOptions

Die optionalen Clienteinstellungen.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn das angegebene hostName oder credential NULL ist.

ArgumentException

Wird ausgelöst, wenn die bereitgestellte hostName leer oder leer ist.

Hinweise

Weitere Informationen zu den Authentifizierungsoptionen mit einem abgeleiteten instance von TokenCredentialfinden Sie unter https://docs.microsoft.com/dotnet/api/overview/azure/identity-readme. Weitere Informationen zum Konfigurieren von IoT Hub mit Azure Active Directory finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac