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 を使用しないでください。

Note

アプリでは、検索ボックス (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) と SearchPane の両方を使用することはできません。 同じアプリで検索ボックスと検索ウィンドウの両方を使用すると、"型 'Windows.UI.Xaml.Controls.SearchBox.' のインスタンスを作成できません"というメッセージでアプリが例外をスローします。

検索履歴コンテキスト文字列は、検索履歴を格納するためのセカンダリ キーとして使用されます (主キーは AppId です)。 アプリでは、検索履歴コンテキスト文字列を使用して、アプリケーションのコンテキストに基づいてさまざまな検索履歴を格納できます。

このプロパティを設定しない場合、Windows では、アプリ内のすべての検索が同じコンテキストで行われると想定されます。 検索ウィンドウが開いているときに、提案が表示されている状態でこのプロパティを更新した場合、ユーザーが次の文字を入力するまで変更は有効になりません。

こちらもご覧ください

• SearchPane
• SearchHistoryEnabled