ProvisioningDeviceClient.RegisterAsync Methode
Definition
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.
Überlädt
| RegisterAsync(CancellationToken) |
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu. |
| RegisterAsync(TimeSpan) |
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu. |
| RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken) |
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu. |
| RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan) |
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu. |
| RegisterAsync(RegistrationRequestPayload, CancellationToken) |
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu. |
RegisterAsync(CancellationToken)
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu.
public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (System.Threading.CancellationToken cancellationToken = default);member this.RegisterAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>Public Function RegisterAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DeviceRegistrationResult)Parameter
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Das Registrierungsergebnis.
Hinweise
Da die von dieser Bibliothek verwendete AMQP-Bibliothek keine Abbruchtoken akzeptiert, wird das bereitgestellte Abbruchtoken nur zwischen AMQP-Vorgängen und nicht während auf Abbruch überprüft. Um ein Timeout für diesen Vorgang zu erhalten, das während AMQP-Vorgängen (z. B. dem Öffnen der Verbindung) überprüft wird, müssen Sie stattdessen verwenden RegisterAsync(TimeSpan) . MQTT- und HTTPS-Verbindungen weisen in dieser Hinsicht nicht das gleiche Verhalten wie AMQP-Verbindungen auf. MQTT- und HTTPS-Verbindungen überprüfen dieses Abbruchtoken während der Vorgänge auf Protokollebene auf Abbruch.
Gilt für:
RegisterAsync(TimeSpan)
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu.
public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (TimeSpan timeout);member this.RegisterAsync : TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>Public Function RegisterAsync (timeout As TimeSpan) As Task(Of DeviceRegistrationResult)Parameter
- timeout
- TimeSpan
Die maximale Zeit, für die dieser Vorgang ausgeführt werden kann, bevor ein Timeout erfolgt.
Gibt zurück
Das Registrierungsergebnis.
Hinweise
Da die von dieser Bibliothek verwendete AMQP-Bibliothek keine Abbruchtoken akzeptiert, sind diese Überladungen RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan) die einzigen Überladungen für diese Methode, die es ermöglichen, dass ein angegebenes Timeout in der Mitte eines AMQP-Vorgangs wie das Öffnen der AMQP-Verbindung eingehalten wird. MQTT- und HTTPS-Verbindungen haben jedoch nicht dieselbe Einschränkung.
Gilt für:
RegisterAsync(ProvisioningRegistrationAdditionalData, CancellationToken)
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu.
public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData data, System.Threading.CancellationToken cancellationToken = default);member this.RegisterAsync : Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>Public Function RegisterAsync (data As ProvisioningRegistrationAdditionalData, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DeviceRegistrationResult)Parameter
Die optionalen zusätzlichen Daten, die an den Webhook für die benutzerdefinierte Zuordnungsrichtlinie übergeben werden, wenn ein webhook für eine benutzerdefinierte Zuordnungsrichtlinie für diese Registrierung eingerichtet wird.
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Das Registrierungsergebnis.
Hinweise
Da die von dieser Bibliothek verwendete AMQP-Bibliothek keine Abbruchtoken akzeptiert, wird das bereitgestellte Abbruchtoken nur zwischen AMQP-Vorgängen und nicht während auf Abbruch überprüft. Um ein Timeout für diesen Vorgang zu erhalten, das bei AMQP-Vorgängen (z. B. dem Öffnen der Verbindung) überprüft wird, müssen Sie stattdessen diese Überladung verwenden. MQTT- und HTTPS-Verbindungen weisen in dieser Hinsicht nicht das gleiche Verhalten wie AMQP-Verbindungen auf. MQTT- und HTTPS-Verbindungen überprüfen dieses Abbruchtoken während der Vorgänge auf Protokollebene auf Abbruch.
Gilt für:
RegisterAsync(ProvisioningRegistrationAdditionalData, TimeSpan)
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu.
public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData data, TimeSpan timeout);member this.RegisterAsync : Microsoft.Azure.Devices.Provisioning.Client.ProvisioningRegistrationAdditionalData * TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>Public Function RegisterAsync (data As ProvisioningRegistrationAdditionalData, timeout As TimeSpan) As Task(Of DeviceRegistrationResult)Parameter
Die optionalen zusätzlichen Daten, die an den Webhook für die benutzerdefinierte Zuordnungsrichtlinie übergeben werden, wenn ein webhook für eine benutzerdefinierte Zuordnungsrichtlinie für diese Registrierung eingerichtet wird.
- timeout
- TimeSpan
Die maximale Zeit, für die dieser Vorgang ausgeführt werden kann, bevor ein Timeout erfolgt.
Gibt zurück
Das Registrierungsergebnis.
Hinweise
Da die von dieser Bibliothek verwendete AMQP-Bibliothek keine Abbruchtoken akzeptiert, sind diese Überladungen RegisterAsync(TimeSpan) die einzigen Überladungen für diese Methode, die es ermöglichen, dass ein angegebenes Timeout in der Mitte eines AMQP-Vorgangs wie das Öffnen der AMQP-Verbindung eingehalten wird. MQTT- und HTTPS-Verbindungen haben jedoch nicht dieselbe Einschränkung.
Gilt für:
RegisterAsync(RegistrationRequestPayload, CancellationToken)
Registriert das aktuelle Gerät mithilfe des Device Provisioning Service und weist es einem IoT Hub zu.
public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult> RegisterAsync (Microsoft.Azure.Devices.Provisioning.Client.RegistrationRequestPayload data, System.Threading.CancellationToken cancellationToken = default);member this.RegisterAsync : Microsoft.Azure.Devices.Provisioning.Client.RegistrationRequestPayload * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Client.DeviceRegistrationResult>Public Function RegisterAsync (data As RegistrationRequestPayload, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DeviceRegistrationResult)Parameter
Die optionalen zusätzlichen Daten, die an den Webhook für die benutzerdefinierte Zuordnungsrichtlinie übergeben werden, wenn ein webhook für eine benutzerdefinierte Zuordnungsrichtlinie für diese Registrierung eingerichtet wird.
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Das Registrierungsergebnis.
Gilt für:
Azure SDK for .NET