DigitalTwinsClient.GetDigitalTwinAsync<T> Método

Definição

Namespace:

Azure.DigitalTwins.Core

Assembly:

Azure.DigitalTwins.Core.dll

Pacote:

Azure.DigitalTwins.Core v1.4.0

Origem:

DigitalTwinsClient.cs

Obtém um gêmeo digital de forma assíncrona.

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

O tipo para o qual desserializar o gêmeo digital.

Parâmetros

digitalTwinId

String

A ID do gêmeo digital.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<Response<T>>

O aplicativo desserializado/gêmeo digital json e a resposta Response<T>HTTP .

Exceções

RequestFailedException

A exceção que captura os erros do serviço. Verifique as ErrorCode propriedades e Status para obter mais detalhes.

ArgumentNullException

A exceção é gerada quando digitalTwinId é null.

Exemplos

Este exemplo demonstra a obtenção e desserialização de um gêmeo digital em um tipo de dados 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}");

Comentários

Um tipo de objeto fortemente tipado, como BasicDigitalTwin , pode ser usado como um tipo genérico para T indicar qual tipo é usado para desserializar o valor de resposta. Ele também pode ser desserializado em tipos de gêmeo digital personalizados que estendem o BasicDigitalTwin com propriedades adicionais fortemente tipadas, desde que você saiba a definição do gêmeo digital recuperado antes da desserialização.

Para obter mais exemplos, confira nossos exemplos de repositório.