共用方式為


SearchPane.SearchHistoryEnabled 屬性

定義

指出使用者先前使用應用程式的搜尋是否會自動追蹤,並用來提供建議。

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);
/// [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, typeof(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, typeof(Windows.ApplicationModel.Search.SearchContract))] set; }
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

屬性值

Boolean

bool

True 是表示 如果使用者的搜尋歷程記錄會自動追蹤,並用來提供建議;否則為 false。 預設值為 true。

屬性

備註

重要

若要在應用程式中實作Windows 10或更新版本的搜尋,請使用AutoSuggestBox。 如需詳細資訊,請參閱 自動建議方塊

您不應該在 app 中使用Windows.ApplicationModel.Search API (SearchPaneSearchContract) 或SearchBox API,以進行Windows 10或更新版本。

注意

應用程式無法使用搜尋方塊 (Windows.UI.Xaml.Controls.SearchBoxWinJS.UI.SearchBox/) 和 SearchPane。 在相同的應用程式中同時使用搜尋方塊和搜尋窗格,會導致應用程式擲回例外狀況,並顯示下列訊息:「無法建立類型為 'Windows.UI.Xaml.Controls.SearchBox'的實例。」

您可以將此屬性設定為 false,以退出宣告自動建議;您的應用程式可以選擇性地向使用者提供自己的建議。 如果您決定讓 app 追蹤自己的搜尋歷程記錄,您也應該讓使用者透過 [設定] 常用鍵來控制其歷程記錄,例如清除歷程記錄的能力。

如果您在搜尋窗格開啟時設定此屬性,則在使用者輸入其查詢的下一個字元之前,變更才會生效。

適用於

另請參閱