SearchBox.SetLocalContentSuggestionSettings 方法

定義

命名空間:

Windows.UI.Xaml.Controls

指定根據本機檔案的建議是否會自動顯示在搜尋方塊建議中，並定義 Windows 用來尋找和篩選這些建議的準則。

public:
 virtual void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings ^ settings) = SetLocalContentSuggestionSettings;

void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings const& settings);

public void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings settings);

function setLocalContentSuggestionSettings(settings)

Public Sub SetLocalContentSuggestionSettings (settings As LocalContentSuggestionSettings)

參數

settings

LocalContentSuggestionSettings

本機內容建議的新設定。

範例

在這裡，建議僅限於使用 AQS 字串的一種檔案、音樂檔案。 其中兩個最常見的 AQS 篩選準則會根據檔案類型來限制，例如範例中的 「kind：music」 ;和 以副檔名為基礎，例如 「ext:.mp3」。

public MainPage()
{
    this.InitializeComponent();

    // Let Windows provide suggestions from local files.
    var settings = new Windows.ApplicationModel.Search.LocalContentSuggestionSettings();
    settings.Enabled = true;
    // Access to the music library requires that the Music Library capability
    // be declared in the app manifest .
    settings.Locations.Add(Windows.Storage.KnownFolders.MusicLibrary);
    settings.AqsFilter = "kind:Music";
    MySearchBox.SetLocalContentSuggestionSettings(settings);
}

備註

啟用本機內容建議時，Windows 會在使用者輸入查詢文字時，提供使用者的本機檔案搜尋建議。 例如，圖片應用程式可以設定本機內容建議，讓搜尋建議只來自儲存在使用者圖片庫中的特定影像檔。

若要搜尋本機程式庫，必須在應用程式資訊清單中宣告適當的功能。 如需詳細資訊，請參閱應用程式功能宣告。