SearchPane.SearchHistoryContext | searchHistoryContext property

Applies to Windows only

A string that identifies the context of the search and is used to store the user's search history with the app.

Syntax


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

Property value

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The search history context string.

Remarks

Note  An app can't use both the search box (Windows.UI.Xaml.Controls.SearchBox for Windows Store apps using C++, C#, or Visual Basic, WinJS.UI.SearchBox for Windows Store apps using JavaScript) and the SearchPane. Using both the search box and the search pane in the same app causes the app to throw an exception with this message: "Cannot create instance of type 'Windows.UI.Xaml.Controls.SearchBox.'"

The search history context string is used as a secondary key for storing search history. (The primary key is the AppId.) An app can use the search history context string to store different search histories based on the context of the application.

If you don't set this property, Windows assumes that all searches in your app occur in the same context. If you update this property while the search pane is open with suggestions showing, the changes won't take effect until the user enters the next character.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

Windows.ApplicationModel.Search
Windows::ApplicationModel::Search [C++]

Metadata

Windows.winmd

See also

SearchPane class
SearchPane.SearchHistoryEnabled property

 

 

Show:
© 2014 Microsoft