SearchPane.SearchHistoryEnabled Eigenschaft

Definition

Namespace:

Windows.ApplicationModel.Search

Gibt an, ob die vorherigen Suchvorgänge des Benutzers mit der App automatisch nachverfolgt und zum Bereitstellen von Vorschlägen verwendet werden.

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

Eigenschaftswert

Boolean

bool

True, wenn der Suchverlauf des Benutzers automatisch nachverfolgt und zum Bereitstellen von Vorschlägen verwendet wird; andernfalls false. Der Standardwert lautet „true“.

Attribute

DeprecatedAttribute

Hinweise

Wichtig

Verwenden Sie AutoSuggestBox, um die Suche in einer App für Windows 10 oder höher zu implementieren. Weitere Informationen finden Sie unter Automatische Vorschläge .

Sie sollten keine Windows.ApplicationModel.Search-APIs (SearchPane, SearchContract) oder SearchBox-APIs in Apps für Windows 10 oder höher verwenden.

Hinweis

Eine App kann nicht sowohl das Suchfeld (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) als auch die SearchPane verwenden. Wenn Sie sowohl das Suchfeld als auch den Suchbereich in derselben App verwenden, löst die App eine Ausnahme mit der folgenden Meldung aus: "Es kann keine Instanz vom Typ 'Windows.UI.Xaml.Controls.SearchBox' erstellt werden."

Sie können diese Eigenschaft auf false festlegen, um automatische Vorschläge zu deaktivieren. Ihre App kann benutzern optional eigene Vorschläge bereitstellen. Wenn Sie entscheiden, dass Ihre App ihren eigenen Suchverlauf nachverfolgen soll, sollten Sie dem Benutzer auch eine gewisse Kontrolle über den Verlauf über den Charm "Einstellungen" geben, z. B. die Möglichkeit, den Verlauf zu löschen.

Wenn Sie diese Eigenschaft festlegen, während der Suchbereich geöffnet ist, wird die Änderung erst wirksam, wenn der Benutzer das nächste Zeichen seiner Abfrage eingibt.

Weitere Informationen

• SearchPane
• SearchHistoryContext