Compartilhar via


DigitalTwinsClient.QueryAsync<T>(String, CancellationToken) Método

Definição

Consulta gêmeos digitais iterando por meio de uma coleção de forma assíncrona.

public virtual Azure.AsyncPageable<T> QueryAsync<T> (string query, System.Threading.CancellationToken cancellationToken = default);
abstract member QueryAsync : string * System.Threading.CancellationToken -> Azure.AsyncPageable<'T>
override this.QueryAsync : string * System.Threading.CancellationToken -> Azure.AsyncPageable<'T>
Public Overridable Function QueryAsync(Of T) (query As String, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of T)

Parâmetros de tipo

T

O tipo para o qual desserializar o resultado.

Parâmetros

query
String

A cadeia de caracteres de consulta, na sintaxe semelhante a SQL.

cancellationToken
CancellationToken

O token de cancelamento.

Retornos

A lista AsyncPageable<T> paginável dos resultados da consulta.

Exceções

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

Exemplos

// This code snippet demonstrates the simplest way to iterate over the digital twin results, where paging
// happens under the covers.
AsyncPageable<BasicDigitalTwin> asyncPageableResponse = client.QueryAsync<BasicDigitalTwin>("SELECT * FROM digitaltwins");

// Iterate over the twin instances in the pageable response.
// The "await" keyword here is required because new pages will be fetched when necessary,
// which involves a request to the service.
await foreach (BasicDigitalTwin twin in asyncPageableResponse)
{
    Console.WriteLine($"Found digital twin '{twin.Id}'");
}

Comentários

Para obter mais exemplos, confira nossos exemplos de repositório. Observe que pode haver um atraso entre antes que as alterações em sua instância sejam refletidas em consultas. Para obter mais detalhes sobre limitações de consulta, consulte Limitações de consulta.

Aplica-se a

Confira também