IotHubServiceClient Construtores

Definição

Namespace:

Microsoft.Azure.Devices

Assembly:

Microsoft.Azure.Devices.dll

Pacote:

Microsoft.Azure.Devices v2.0.0-preview002

Sobrecargas

IotHubServiceClient()	Cria uma instância dessa classe. Fornecido apenas para fins de teste de unidade.
IotHubServiceClient(String, IotHubServiceClientOptions)	Crie uma instância dessa classe que autentique solicitações de serviço usando uma cadeia de conexão do Hub IoT.
IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)	Crie uma instância dessa classe que autentique solicitações de serviço com uma assinatura de acesso compartilhado fornecida e atualizada conforme necessário pelo chamador.
IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)	Crie uma instância dessa classe que autentique solicitações de serviço usando uma identidade no AAD (Azure Active Directory).

IotHubServiceClient()

Cria uma instância dessa classe. Fornecido apenas para fins de teste de unidade.

protected IotHubServiceClient ();

Protected Sub New ()

IotHubServiceClient(String, IotHubServiceClientOptions)

Crie uma instância dessa classe que autentique solicitações de serviço usando uma cadeia de conexão do Hub IoT.

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)

Parâmetros

connectionString

String

A cadeia de conexão do hub IoT.

options

IotHubServiceClientOptions

As configurações opcionais do cliente.

Exceções

ArgumentNullException

Gerada quando a cadeia de conexão fornecida é nula.

ArgumentException

Gerada quando a cadeia de conexão fornecida está vazia ou espaço em branco.

IotHubServiceClient(String, AzureSasCredential, IotHubServiceClientOptions)

Crie uma instância dessa classe que autentique solicitações de serviço com uma assinatura de acesso compartilhado fornecida e atualizada conforme necessário pelo chamador.

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)

Parâmetros

hostName

String

Nome do host do Hub IoT. Por exemplo: "my-iot-hub.azure-devices.net".

credential

AzureSasCredential

Credencial que gera um token SAS para autenticar com o Hub IoT. Consulte AzureSasCredential.

options

IotHubServiceClientOptions

As configurações opcionais do cliente.

Exceções

ArgumentNullException

Gerado quando o fornecido hostName ou credential é nulo.

ArgumentException

Gerado quando o fornecido hostName está vazio ou espaço em branco.

Comentários

Os usuários podem querer criar seus próprios tokens sas (assinatura de acesso compartilhado) em vez de dar a chave compartilhada ao SDK e permitir que ele gerencie a assinatura e a renovação. O AzureSasCredential objeto fornece ao SDK acesso ao token SAS, enquanto o chamador pode atualizá-lo conforme necessário usando o Update(String) método .

IotHubServiceClient(String, TokenCredential, IotHubServiceClientOptions)

Crie uma instância dessa classe que autentique solicitações de serviço usando uma identidade no AAD (Azure Active Directory).

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)

Parâmetros

hostName

String

Nome do host do Hub IoT. Por exemplo: "my-iot-hub.azure-devices.net".

credential

TokenCredential

Credenciais do AAD (Azure Active Directory) para autenticar com o Hub IoT.

options

IotHubServiceClientOptions

As configurações opcionais do cliente.

Exceções

ArgumentNullException

Gerado quando o fornecido hostName ou credential é nulo.

ArgumentException

Gerado quando o fornecido hostName está vazio ou espaço em branco.

Comentários

Para obter mais informações sobre as opções de autenticação usando uma instância derivada do TokenCredential, consulte https://docs.microsoft.com/dotnet/api/overview/azure/identity-readme. Para obter mais informações sobre como configurar o Hub IoT com o Azure Active Directory, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac