SearchClient.GetDocument<T> 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.
Récupère un document à partir de Recherche cognitive Azure. Cela est utile quand un utilisateur clique sur un résultat de recherche en particulier et que vous voulez rechercher des détails spécifiques sur ce document. Vous ne pouvez obtenir qu'un seul document à la fois. Utilisez Search pour obtenir plusieurs documents dans une requête unique. Recherche de document
public virtual Azure.Response<T> GetDocument<T> (string key, Azure.Search.Documents.GetDocumentOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GetDocument : string * Azure.Search.Documents.GetDocumentOptions * System.Threading.CancellationToken -> Azure.Response<'T>
override this.GetDocument : string * Azure.Search.Documents.GetDocumentOptions * System.Threading.CancellationToken -> Azure.Response<'T>
Public Overridable Function GetDocument(Of T) (key As String, Optional options As GetDocumentOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(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
- key
- String
Obligatoire. Valeur de chaîne qui identifie de manière unique chaque document dans l’index. La clé est parfois appelée ID de document. Consultez Règles de nommage pour connaître les règles de construction de clés de document valides.
- options
- GetDocumentOptions
Options permettant de personnaliser le comportement de l’opération.
- cancellationToken
- CancellationToken
Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.
Retours
Document correspondant à .key
Exceptions
Levée lorsqu’un échec est retourné par le service de recherche.
Remarques
Les surcharges génériques des méthodes et GetDocumentAsync<T>(String, GetDocumentOptions, CancellationToken) prennent en charge le GetDocument<T>(String, GetDocumentOptions, CancellationToken) mappage des types de champs Recherche Azure aux types .NET via le paramètre T
type . Notez que tous les types de champs de recherche à l’exception des collections sont nullables. Nous vous recommandons donc d’utiliser des types nullables pour les propriétés de T
. Consultez la rubrique GetDocumentAsync<T>(String, GetDocumentOptions, CancellationToken) (éventuellement en anglais) pour plus d'informations.
S’applique à
Azure SDK for .NET