DigitalTwinsClient.GetDigitalTwinAsync<T> Methode

Referenz

Definition

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Paket:: Azure.DigitalTwins.Core v1.4.0

Source:: DigitalTwinsClient.cs

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.

Ruft asynchron einen digitalen Zwilling ab.

public virtual System.Threading.Tasks.Task<Azure.Response<T>> GetDigitalTwinAsync<T> (string digitalTwinId, System.Threading.CancellationToken cancellationToken = default);

abstract member GetDigitalTwinAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<'T>>
override this.GetDigitalTwinAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<'T>>

Public Overridable Function GetDigitalTwinAsync(Of T) (digitalTwinId As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of T))

Typparameter

T

Der Typ, in den der digitale Zwilling deserialisiert werden soll.

Parameter

digitalTwinId: String

Die ID des digitalen Zwillings.

cancellationToken: CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<Response<T>>

Der deserialisierte digitale Zwilling anwendung/json und die HTTP-Antwort Response<T>.

Ausnahmen

RequestFailedException

Die Ausnahme, die die Fehler des Diensts erfasst. Weitere Details finden Sie in den ErrorCode Eigenschaften und Status .

ArgumentNullException

Die Ausnahme wird ausgelöst, wenn digitalTwinId ist null.

Beispiele

In diesem Beispiel wird das Abrufen und Deserialisieren eines digitalen Zwillings in einen benutzerdefinierten Datentyp veranschaulicht.

Response<CustomDigitalTwin> getCustomDtResponse = await client.GetDigitalTwinAsync<CustomDigitalTwin>(customDtId);
CustomDigitalTwin customDt = getCustomDtResponse.Value;
Console.WriteLine($"Retrieved and deserialized digital twin {customDt.Id}:\n\t" +
    $"ETag: {customDt.ETag}\n\t" +
    $"ModelId: {customDt.Metadata.ModelId}\n\t" +
    $"Prop1: [{customDt.Prop1}] last updated on {customDt.Metadata.Prop1.LastUpdatedOn}\n\t" +
    $"Prop2: [{customDt.Prop2}] last updated on {customDt.Metadata.Prop2.LastUpdatedOn}\n\t" +
    $"ComponentProp1: [{customDt.Component1.ComponentProp1}] last updated {customDt.Component1.Metadata.ComponentProp1.LastUpdatedOn}\n\t" +
    $"ComponentProp2: [{customDt.Component1.ComponentProp2}] last updated {customDt.Component1.Metadata.ComponentProp2.LastUpdatedOn}");

Hinweise

Ein stark typisierter Objekttyp wie BasicDigitalTwin kann als generischer Typ für T verwendet werden, um anzugeben, welcher Typ zum Deserialisieren deserialisieren des Antwortwerts verwendet wird. Es kann auch in benutzerdefinierte digitale Zwillingstypen deserialisiert werden, die den BasicDigitalTwin mit zusätzlichen stark typisierten Eigenschaften erweitern, vorausgesetzt, Sie kennen die Definition des abgerufenen digitalen Zwillings vor der Deserialisierung.

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Freigeben über