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

Définition

Recherche des documents dans l’index de recherche. Recherche dans des documents

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

Paramètres de type

T

Type .NET mappé au schéma d’index. Les instances de ce type peuvent être récupérées sous forme de documents à partir de l’index.

Paramètres

searchText
String

Expression de requête de recherche en texte intégral ; Utilisez « * » ou omettez ce paramètre pour faire correspondre tous les documents. Pour plus d’informations sur la syntaxe de requête de recherche, consultez Syntaxe de requête simple dans Recherche cognitive Azure.

options
SearchOptions

Options qui permettent de spécifier le filtrage, le tri, les facettes, la pagination et d’autres comportements de requête de recherche.

cancellationToken
CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Réponse contenant les documents correspondant à la requête.

Exceptions

Levée lorsqu’un échec est retourné par le service de recherche.

Remarques

Les méthodes Search et SearchAsync prennent en charge le mappage des types de champs de recherche aux types .NET via le paramètre de type T. Vous pouvez fournir votre propre type T ou utiliser le dynamique SearchDocument. Pour plus d’informations sur le mappage de type, consultez GetDocumentAsync<T>(String, GetDocumentOptions, CancellationToken) .

Recherche cognitive Azure ne sera peut-être pas en mesure d’inclure tous les résultats dans une seule réponse, auquel cas GetResults() continuera automatiquement à effectuer des demandes supplémentaires à mesure que vous énumérez les résultats. Vous pouvez également traiter les résultats une page à la fois avec la AsPages(String, Nullable<Int32>) méthode .

S’applique à