SearchPane.SearchHistoryContext Proprietà

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Search

Stringa che identifica il contesto della ricerca e viene usata per archiviare la cronologia di ricerca dell'utente con l'app.

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

Valore della proprietà

String

Platform::String

winrt::hstring

Stringa di contesto della cronologia di ricerca.

Attributi

DeprecatedAttribute

Commenti

Importante

Per implementare la ricerca in un'app per Windows 10 o versione successiva, usare AutoSuggestBox. Per altre informazioni, vedi Casella di suggerimento automatico .

Non è consigliabile usare le API Windows.ApplicationModel.Search (SearchPane, SearchContract) o SearchBox nelle app per Windows 10 o versioni successive.

Nota

Un'app non può usare sia la casella di ricerca (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) che searchPane. L'uso della casella di ricerca e del riquadro di ricerca nella stessa app fa sì che l'app generi un'eccezione con questo messaggio: "Impossibile creare un'istanza di tipo 'Windows.UI.Xaml.Controls.SearchBox'".

La stringa di contesto della cronologia di ricerca viene usata come chiave secondaria per archiviare la cronologia di ricerca (la chiave primaria è AppId). Un'app può usare la stringa di contesto della cronologia di ricerca per archiviare cronologie di ricerca diverse in base al contesto dell'applicazione.

Se non imposti questa proprietà, Windows presuppone che tutte le ricerche nell'app si verifichino nello stesso contesto. Se si aggiorna questa proprietà mentre il riquadro di ricerca è aperto con suggerimenti visualizzati, le modifiche non verranno applicate fino a quando l'utente non immette il carattere successivo.

Vedi anche

• SearchPane
• SearchHistoryEnabled