Windows 8 風格應用開發入門：搜尋合約完整實作教學

本文示範從專案範本添加搜尋合約頁面、資料繫結、搜尋建議/推薦、外部啟動處理、本地搜尋與歷史管理的完整實作流程。

啟用搜尋權限與添加頁面

1. 清單檔「功能」啟用相關檔案存取權限
2. 方案總管右鍵 → 「加入」→「新增項目」→「搜尋合約」
3. 自動產生 SearchResultsPage.xaml 與對應程式碼

預設搜尋結果頁面樣板

產生的頁面包含查詢文字顯示、結果計數、GridView 結果列表等控件。

LoadState 方法實作搜尋邏輯

protected override void LoadState(Object navigationParameter, 
    Dictionary<String, Object> pageState) {
    var queryText = navigationParameter as String;
    var results = SearchData(queryText); // 應用資料搜尋邏輯
    DefaultViewModel["Results"] = results;
    DefaultViewModel["QueryText"] = queryText;
}

自訂結果項目樣板

修改 Common/StandardStyles.xaml 中的 StandardSmallIcon300x70ItemTemplate。

執行效果驗證

應用外部啟動搜尋處理

在 App.xaml.cs 重寫 OnSearchActivated：

protected override void OnSearchActivated(SearchActivatedEventArgs args) {
    if (args.PreviousExecutionState == ApplicationExecutionState.NotRunning ||
        args.PreviousExecutionState == ApplicationExecutionState.ClosedByUser ||
        args.PreviousExecutionState == ApplicationExecutionState.Terminated) {
        // 載入資料、註冊建議事件
        LoadData();
        SearchPane.GetForCurrentView().SuggestionsRequested += OnSuggestionsRequested;
    }
    // 導航至搜尋結果頁
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(SearchResultsPage), args.QueryText);
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

自訂搜尋框預留文字

SearchPane.GetForCurrentView().PlaceholderText = "搜尋產品、分類...";

搜尋建議實作

private void OnSuggestionsRequested(SearchPane sender, 
    SearchPaneSuggestionsRequestedEventArgs args) {
    var deferral = args.Request.GetDeferral();
    var suggestions = GetSuggestions(args.QueryText); // 非同步取得建議
    foreach (var s in suggestions) {
        args.Request.SearchSuggestionCollection.AppendQuerySuggestion(s);
    }
    deferral.Complete();
}

搜尋分隔與推薦

// 添加分隔線
args.Request.SearchSuggestionCollection.AppendSearchSeparator("分類");

// 搜尋推薦：帶縮圖、詳細資訊，點擊直接跳轉
args.Request.SearchSuggestionCollection.AppendResultSuggestion(
    "產品名稱", "詳細描述", "productId", 
    RandomAccessStreamReference.CreateFromUri(new Uri("ms-appx:///Assets/thumb.jpg")),
    "替代文字");

建議與推薦差異比較

本地檔案搜尋建議

var settings = new LocalContentSuggestionSettings();
settings.AqsFilter = "kind:picture"; // 圖片類型
settings.Locations.Add(KnownFolders.PicturesLibrary);
SearchPane.GetForCurrentView().SetLocalContentSuggestionSettings(settings);
// 需清單檔啟用圖片庫權限

搜尋歷史管理

// 關閉搜尋歷史
SearchPane.GetForCurrentView().ShowOnKeyboardInput = false;

// 搜尋歷史上下文：區分不同搜尋場景
SearchPane.GetForCurrentView().SearchHistoryContext = "productSearch";

搜尋合約實作完成，應用已整合至系統級搜尋體驗。下一章將介紹分享合約架構。