SearchClient.Search<T>(String, SearchOptions, CancellationToken) Método

Definição

Pesquisa documentos no índice de pesquisa. Pesquisar documentos

public virtual Azure.Response<Azure.Search.Documents.Models.SearchResults<T>> Search<T> (string searchText, Azure.Search.Documents.SearchOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member Search : string * Azure.Search.Documents.SearchOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Models.SearchResults<'T>>
override this.Search : string * Azure.Search.Documents.SearchOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Models.SearchResults<'T>>
Public Overridable Function Search(Of T) (searchText As String, Optional options As SearchOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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

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

Exceções

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 casoGetResults(), 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 .

Aplica-se a