SearchPane.SearchHistoryEnabled Proprietà

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Search

Indica se le ricerche precedenti dell'utente con l'app vengono rilevate automaticamente e usate per fornire suggerimenti.

public:
 property bool SearchHistoryEnabled { bool get(); void set(bool 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")]
bool SearchHistoryEnabled();

void SearchHistoryEnabled(bool value);

public bool SearchHistoryEnabled { [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 boolean = searchPane.searchHistoryEnabled;
searchPane.searchHistoryEnabled = boolean;

Public Property SearchHistoryEnabled As Boolean

Valore della proprietà

Boolean

bool

True se la cronologia di ricerca dell'utente viene automaticamente rilevata e usata per fornire suggerimenti; in caso contrario false. Il valore predefinito è true.

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'".

È possibile impostare questa proprietà su false per rifiutare esplicitamente i suggerimenti automatici; l'app può facoltativamente fornire suggerimenti agli utenti. Se decidi di tenere traccia della cronologia di ricerca della tua app, devi anche dare all'utente un controllo sulla cronologia tramite l'accesso Alle impostazioni, ad esempio la possibilità di cancellare la cronologia.

Se si imposta questa proprietà mentre il riquadro di ricerca è aperto, la modifica non avrà effetto fino a quando l'utente non immette il carattere successivo della query.

Vedi anche

• SearchPane
• SearchHistoryContext