IotHubServiceClient Constructeurs

Définition

Espace de noms:

Microsoft.Azure.Devices

Assembly:

Microsoft.Azure.Devices.dll

Paquet:

Microsoft.Azure.Devices v2.0.0-preview002

Surcharges

IotHubServiceClient()	Crée une instance de cette classe. Fourni à des fins de test unitaire uniquement.
IotHubServiceClient(String, IotHubServiceClientOptions)	Créez une instance de cette classe qui authentifie les demandes de service à l’aide d’une chaîne de connexion IoT Hub.
IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)	Créez une instance de cette classe qui authentifie les demandes de service avec une signature d’accès partagé fournie et actualisée si nécessaire par l’appelant.
IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)	Créez une instance de cette classe qui authentifie les demandes de service à l’aide d’une identité dans Azure Active Directory (AAD).

IotHubServiceClient()

Crée une instance de cette classe. Fourni à des fins de test unitaire uniquement.

protected IotHubServiceClient();

Protected Sub New ()

IotHubServiceClient(String, IotHubServiceClientOptions)

Créez une instance de cette classe qui authentifie les demandes de service à l’aide d’une chaîne de connexion IoT Hub.

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)

Paramètres

connectionString

String

Chaîne de connexion IoT Hub.

options

IotHubServiceClientOptions

Paramètres client facultatifs.

Exceptions

ArgumentNullException

Levée lorsque la chaîne de connexion fournie est null.

ArgumentException

Levée lorsque la chaîne de connexion fournie est vide ou espace blanc.

IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)

Créez une instance de cette classe qui authentifie les demandes de service avec une signature d’accès partagé fournie et actualisée si nécessaire par l’appelant.

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)

Paramètres

hostName

String

Nom d’hôte du hub IoT. Pour instance : « my-iot-hub.azure-devices.net ».

credential

AzureSasCredential

Informations d’identification qui génèrent un jeton SAP pour l’authentification auprès d’IoT Hub. Consultez AzureSasCredential.

options

IotHubServiceClientOptions

Paramètres client facultatifs.

Exceptions

ArgumentNullException

Levée lorsque le fourni hostName ou credential est null.

ArgumentException

Levée lorsque le fourni hostName est vide ou espace blanc.

Remarques

Les utilisateurs peuvent souhaiter créer leurs propres jetons de signature d’accès partagé (SAP) plutôt que de donner la clé partagée au KIT de développement logiciel (SDK) et de le laisser gérer la signature et le renouvellement. L’objet AzureSasCredential donne au SDK l’accès au jeton SAS, tandis que l’appelant peut le mettre à jour si nécessaire à l’aide de la Update(String) méthode .

IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)

Créez une instance de cette classe qui authentifie les demandes de service à l’aide d’une identité dans Azure Active Directory (AAD).

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)

Paramètres

hostName

String

Nom d’hôte du hub IoT. Pour instance : « my-iot-hub.azure-devices.net ».

credential

TokenCredential

Informations d’identification Azure Active Directory (AAD) pour l’authentification auprès d’IoT Hub.

options

IotHubServiceClientOptions

Paramètres client facultatifs.

Exceptions

ArgumentNullException

Levée lorsque le fourni hostName ou credential est null.

ArgumentException

Levée lorsque le fourni hostName est vide ou espace blanc.

Remarques

Pour plus d’informations sur les options d’authentification à l’aide d’un instance dérivé de TokenCredential, consultez https://docs.microsoft.com/dotnet/api/overview/azure/identity-readme. Pour plus d’informations sur la configuration d’IoT Hub avec Azure Active Directory, consultez https://docs.microsoft.com/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac