DigitalTwinsClient.GetDigitalTwinAsync<T> Méthode

Référence

Définition

Espace de noms:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Paquet:: Azure.DigitalTwins.Core v1.4.0

Source:: DigitalTwinsClient.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient un jumeau numérique de façon asynchrone.

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

Paramètres de type

T

Type vers lequel désérialiser le jumeau numérique.

Paramètres

digitalTwinId: String

Id du jumeau numérique.

cancellationToken: CancellationToken

Jeton d'annulation.

Retours

Task<Response<T>>

Le jumeau numérique application/json désérialisé et la réponse Response<T>HTTP .

Exceptions

RequestFailedException

Exception qui capture les erreurs du service. Pour plus d’informations, consultez les ErrorCode propriétés et Status .

ArgumentNullException

L’exception est levée quand digitalTwinId est null.

Exemples

Cet exemple montre comment obtenir et désérialiser un jumeau numérique dans un type de données personnalisé.

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}");

Remarques

Un type d’objet fortement typé tel que BasicDigitalTwin peut être utilisé comme type générique pour T indiquer le type utilisé pour désérialiser la valeur de réponse. Il peut également être désérialisé en types de jumeaux numériques personnalisés qui étendent le BasicDigitalTwin avec des propriétés fortement typées supplémentaires, à condition que vous connaissiez la définition du jumeau numérique récupéré avant la désérialisation.

Pour plus d’exemples, consultez nos exemples de dépôt.

S’applique à

Partager via