SearchPane.SearchHistoryContext 속성

정의

네임스페이스:

Windows.ApplicationModel.Search

검색 컨텍스트를 식별하고 앱과 함께 사용자의 검색 기록을 저장하는 데 사용되는 문자열입니다.

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

속성 값

String

Platform::String

winrt::hstring

검색 기록 컨텍스트 문자열입니다.

특성

DeprecatedAttribute

설명

중요

앱에서 Windows 10 이상 검색을 구현하려면 AutoSuggestBox를 사용합니다. 자세한 내용은 자동 제안 상자를 참조하세요.

Windows 10 이상 앱에서 Windows.ApplicationModel.Search API(SearchPane, SearchContract) 또는 SearchBox API를 사용하면 안 됩니다.

참고

앱은 검색 상자(Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox)와 SearchPane을 모두 사용할 수 없습니다. 동일한 앱에서 검색 상자와 검색 창을 모두 사용하면 앱에서 "'Windows.UI.Xaml.Controls.SearchBox' 유형의 인스턴스를 만들 수 없습니다."라는 메시지와 함께 예외가 발생합니다.

검색 기록 컨텍스트 문자열은 검색 기록을 저장하기 위한 보조 키로 사용됩니다(기본 키는 AppId임). 앱은 검색 기록 컨텍스트 문자열을 사용하여 애플리케이션의 컨텍스트에 따라 다른 검색 기록을 저장할 수 있습니다.

이 속성을 설정하지 않으면 Windows는 앱의 모든 검색이 동일한 컨텍스트에서 발생한다고 가정합니다. 검색 창이 표시되는 제안과 함께 열려 있는 동안 이 속성을 업데이트하면 사용자가 다음 문자를 입력할 때까지 변경 내용이 적용되지 않습니다.

추가 정보

• SearchPane
• SearchHistoryEnabled