Partilhar via


IotHubServiceClient Construtores

Definição

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 ()

Aplica-se a

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

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

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

Aplica-se a

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

Gerado quando o fornecido hostName ou credential é nulo.

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 .

Aplica-se a

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

Gerado quando o fornecido hostName ou credential é nulo.

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

Aplica-se a