SearchClient.SearchAsync<T> Método

Definição

Namespace:

Azure.Search.Documents

Assembly:

Azure.Search.Documents.dll

Pacote:

Azure.Search.Documents v11.4.0

Pesquisa documentos no índice de pesquisa. Pesquisar documentos

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Models.SearchResults<T>>> SearchAsync<T> (string searchText, Azure.Search.Documents.SearchOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member SearchAsync : string * Azure.Search.Documents.SearchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Models.SearchResults<'T>>>
override this.SearchAsync : string * Azure.Search.Documents.SearchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Models.SearchResults<'T>>>

Public Overridable Function SearchAsync(Of T) (searchText As String, Optional options As SearchOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SearchResults(Of T)))

Parâmetros de tipo

T

O tipo .NET que mapeia para o esquema de índice. Instâncias desse tipo podem ser recuperadas como documentos do índice.

Parâmetros

searchText

String

Uma expressão de consulta de pesquisa de texto completo; Use "*" ou omita esse parâmetro para corresponder a todos os documentos. Consulte Sintaxe de consulta simples no Azure Cognitive Search para obter mais informações sobre a sintaxe da consulta de pesquisa.

options

SearchOptions

Opções que permitem especificar filtragem, classificação, faceta, paginação e outros comportamentos de consulta de pesquisa.

cancellationToken

CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Task<Response<SearchResults<T>>>

Resposta que contém os documentos que correspondem à consulta.

Exceções

RequestFailedException

Gerado quando uma falha é retornada pelo Serviço de Pesquisa.

Comentários

Os métodos Search e SearchAsync dão suporte ao mapeamento de tipos de campo de pesquisa para tipos .NET por meio do parâmetro de tipo T. Você pode fornecer seu próprio tipo T ou usar o dinâmico SearchDocument. Consulte GetDocumentAsync<T>(String, GetDocumentOptions, CancellationToken) para obter mais detalhes sobre o mapeamento de tipo.

Azure Cognitive Search pode não ser capaz de incluir todos os resultados em uma única resposta, nesse casoGetResultsAsync(), continuará fazendo solicitações adicionais automaticamente à medida que você enumerar pelos resultados. Você também pode processar os resultados de uma página por vez com o AsPages(String, Nullable<Int32>) método .