SearchClient.Search<T>(String, SearchOptions, CancellationToken) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 .