SearchPane.SearchHistoryContext Propriété

Définition

Espace de noms:

Windows.ApplicationModel.Search

Chaîne qui identifie le contexte de la recherche et est utilisée pour stocker l’historique de recherche de l’utilisateur avec l’application.

public:
 property Platform::String ^ SearchHistoryContext { Platform::String ^ get(); void set(Platform::String ^ value); };

/// [get: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [set: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
winrt::hstring SearchHistoryContext();

void SearchHistoryContext(winrt::hstring value);

public string SearchHistoryContext { [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")] get; [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")] set; }

var string = searchPane.searchHistoryContext;
searchPane.searchHistoryContext = string;

Public Property SearchHistoryContext As String

Valeur de propriété

String

Platform::String

winrt::hstring

Chaîne de contexte d’historique de recherche.

Attributs

DeprecatedAttribute

Remarques

Important

Pour implémenter la recherche dans une application pour Windows 10 ou une version ultérieure, utilisez AutoSuggestBox. Pour plus d’informations, consultez la zone de suggestion automatique.

Vous ne devez pas utiliser les API Windows.ApplicationModel.Search (SearchPane, SearchContract) ou les API SearchBox dans les applications pour Windows 10 ou une version ultérieure.

Notes

Une application ne peut pas utiliser à la fois la zone de recherche (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) et searchPane. L’utilisation de la zone de recherche et du volet de recherche dans la même application entraîne la levée d’une exception avec ce message : « Impossible de créer une instance de type 'Windows.UI.Xaml.Controls.SearchBox' »

La chaîne de contexte d’historique de recherche est utilisée comme clé secondaire pour stocker l’historique de recherche (la clé primaire est AppId). Une application peut utiliser la chaîne de contexte d’historique de recherche pour stocker différents historiques de recherche en fonction du contexte de l’application.

Si vous ne définissez pas cette propriété, Windows suppose que toutes les recherches dans votre application se produisent dans le même contexte. Si vous mettez à jour cette propriété alors que le volet de recherche est ouvert avec des suggestions affichées, les modifications n’entreront pas en vigueur tant que l’utilisateur n’aura pas entré le caractère suivant.

Voir aussi

• SearchPane
• SearchHistoryEnabled