SearchClient.Suggest<T> Méthode

Définition

Espace de noms:

Azure.Search.Documents

Assembly:

Azure.Search.Documents.dll

Paquet:

Azure.Search.Documents v11.5.1

Source:

SearchClient.cs

Exécute une requête « search-as-you-type » composée d’une entrée de texte partielle (trois caractères minimum). Elle retourne le texte correspondant trouvé dans les champs prenant en compte le suggesteur. Recherche cognitive Azure recherche des valeurs correspondantes dans les champs prédéfinis dans un suggesteur. Par exemple, si vous activez les suggestions sur un champ de ville, la saisie de « mer » génère des documents contenant « Seattle », « Sea Tac » et « Seaside » (tous les noms de ville réels) pour ce champ. Suggestions

public virtual Azure.Response<Azure.Search.Documents.Models.SuggestResults<T>> Suggest<T> (string searchText, string suggesterName, Azure.Search.Documents.SuggestOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member Suggest : string * string * Azure.Search.Documents.SuggestOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Models.SuggestResults<'T>>
override this.Suggest : string * string * Azure.Search.Documents.SuggestOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Models.SuggestResults<'T>>

Public Overridable Function Suggest(Of T) (searchText As String, suggesterName As String, Optional options As SuggestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of SuggestResults(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 en tant que documents à partir de l’index.

Paramètres

searchText

String

Texte de recherche à utiliser pour suggérer des documents. Doit comprendre 1 caractère au minimum et 100 caractères au maximum.

suggesterName

String

Nom du suggesteur tel que spécifié dans la collection de suggesteurs qui fait partie de la définition d’index.

options

SuggestOptions

Options de filtrage, de tri et autres suggestions de comportements de requête.

cancellationToken

CancellationToken

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

Retours

Response<SuggestResults<T>>

Réponse contenant les résultats de requête de suggestion d’un index.

Exceptions

RequestFailedException

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

Remarques

Les méthodes Suggest et SuggestAsync 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) .