SearchPane.SearchHistoryContext Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
String yang mengidentifikasi konteks pencarian dan digunakan untuk menyimpan riwayat pencarian pengguna dengan aplikasi.
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);
/// [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, 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 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
Nilai Properti
String konteks riwayat pencarian.
- Atribut
Keterangan
Penting
Untuk mengimplementasikan pencarian di aplikasi untuk Windows 10 atau yang lebih baru, gunakan AutoSuggestBox. Lihat Kotak saran otomatis untuk informasi selengkapnya.
Anda tidak boleh menggunakan API Windows.ApplicationModel.Search (SearchPane, SearchContract
) atau SEARCHBox API di aplikasi untuk Windows 10 atau yang lebih baru.
Catatan
Aplikasi tidak dapat menggunakan kotak pencarian (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) dan SearchPane. Menggunakan kotak pencarian dan panel pencarian di aplikasi yang sama menyebabkan aplikasi melemparkan pengecualian dengan pesan ini: "Tidak dapat membuat instans jenis 'Windows.UI.Xaml.Controls.SearchBox.'"
String konteks riwayat pencarian digunakan sebagai kunci sekunder untuk menyimpan riwayat pencarian (kunci utamanya adalah AppId). Aplikasi dapat menggunakan string konteks riwayat pencarian untuk menyimpan riwayat pencarian yang berbeda berdasarkan konteks aplikasi.
Jika Anda tidak mengatur properti ini, Windows mengasumsikan bahwa semua pencarian di aplikasi Anda terjadi dalam konteks yang sama. Jika Anda memperbarui properti ini saat panel pencarian terbuka dengan saran yang ditampilkan, perubahan tidak akan berlaku sampai pengguna memasukkan karakter berikutnya.