DigitalTwinsClient.GetDigitalTwinAsync<T> Método

Definición

Espacio de nombres:

Azure.DigitalTwins.Core

Ensamblado:

Azure.DigitalTwins.Core.dll

Paquete:

Azure.DigitalTwins.Core v1.4.0

Source:

DigitalTwinsClient.cs

Obtiene un gemelo digital de forma asincrónica.

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

Parámetros de tipo

T

Tipo al que se va a deserializar el gemelo digital.

Parámetros

digitalTwinId

String

Identificador del gemelo digital.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<Response<T>>

El gemelo digital json/aplicación deserializado y la respuesta Response<T>HTTP .

Excepciones

RequestFailedException

Excepción que captura los errores del servicio. Consulte las ErrorCode propiedades y Status para obtener más detalles.

ArgumentNullException

La excepción se produce cuando digitalTwinId es null.

Ejemplos

En este ejemplo se muestra cómo obtener y deserializar un gemelo digital en un tipo de datos personalizado.

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

Comentarios

Un tipo de objeto fuertemente tipado, como BasicDigitalTwin , por ejemplo, se puede usar como tipo genérico para T indicar qué tipo se usa para deserializar el valor de respuesta. También se puede deserializar en tipos de gemelos digitales personalizados que amplían con BasicDigitalTwin propiedades fuertemente tipadas adicionales siempre que conozca la definición del gemelo digital recuperado antes de la deserialización.

Para obtener más ejemplos, consulte nuestros ejemplos de repositorio.