SearchPane.SearchHistoryContext Propriedade

Definição

Namespace:

Windows.ApplicationModel.Search

Uma cadeia de caracteres que identifica o contexto da pesquisa e é usada para armazenar o histórico de pesquisa do usuário com o aplicativo.

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

Valor da propriedade

String

Platform::String

winrt::hstring

A cadeia de caracteres de contexto do histórico de pesquisa.

Atributos

DeprecatedAttribute

Comentários

Importante

Para implementar a pesquisa em um aplicativo para Windows 10 ou posterior, use AutoSuggestBox. Confira Caixa de sugestão automática para obter mais informações.

Você não deve usar APIs Windows.ApplicationModel.Search (SearchPane, SearchContract) ou APIs SearchBox em aplicativos para Windows 10 ou posterior.

Observação

Um aplicativo não pode usar a caixa de pesquisa (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) e o SearchPane. Usar a caixa de pesquisa e o painel de pesquisa no mesmo aplicativo faz com que o aplicativo gere uma exceção com esta mensagem: "Não é possível criar uma instância do tipo 'Windows.UI.Xaml.Controls.SearchBox.'"

A cadeia de caracteres de contexto do histórico de pesquisa é usada como uma chave secundária para armazenar o histórico de pesquisa (a chave primária é a AppId). Um aplicativo pode usar a cadeia de caracteres de contexto do histórico de pesquisa para armazenar diferentes históricos de pesquisa com base no contexto do aplicativo.

Se você não definir essa propriedade, o Windows pressupõe que todas as pesquisas em seu aplicativo ocorram no mesmo contexto. Se você atualizar essa propriedade enquanto o painel de pesquisa estiver aberto com sugestões mostrando, as alterações não entrarão em vigor até que o usuário insira o próximo caractere.

Confira também

• SearchPane
• SearchHistoryEnabled