萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

C# ComboBox 自動完成 (AutoComplete) 完整設定指南

前言

WinForms `ComboBox` 內建強大的自動完成功能,支援**下拉建議**、**自動補全**、**自訂資料來源**。本文詳細說明三種資料來源模式與進階技巧。

三種 AutoCompleteSource 模式

1. CustomSource:自訂字串集合 (最常用)

private void SetupAutoComplete()
{
    // 1. 建立字串集合
    var source = new AutoCompleteStringCollection();
    foreach (var name in GetAllUnitNames()) // 從資料庫/快取載入
        source.Add(name);
    
    // 2. 設定 ComboBox
    comboBox1.AutoCompleteCustomSource = source;
    comboBox1.AutoCompleteSource = AutoCompleteSource.CustomSource;
    comboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend; // 關鍵
}

// 取得資料範例
private IEnumerable GetAllUnitNames()
{
    using (var conn = new SqlConnection(connStr))
    using (var cmd = new SqlCommand("SELECT Name FROM Units WHERE Active=1", conn))
    {
        conn.Open();
        using (var reader = cmd.ExecuteReader())
            while (reader.Read()) yield return reader.GetString(0);
    }
}

2. ListItems:直接使用 Items 集合

// 先填入 Items
foreach (var name in GetAllUnitNames()) comboBox1.Items.Add(name);

// 直接指定來源為 Items
comboBox1.AutoCompleteSource = AutoCompleteSource.ListItems;
comboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;

優點:不需額外集合。缺點:Items 過多 (超過 1000) 會影響下拉效能。

3. FileSystem / FileSystemDirectories / HistoryList / AllUrl / AllSystemSources

內建系統來源:檔案系統路徑、網址歷史、Shell 歷史。適用於路徑輸入、網址列。

comboBox1.AutoCompleteSource = AutoCompleteSource.FileSystem;
comboBox1.AutoCompleteMode = AutoCompleteMode.Suggest;

AutoCompleteMode 詳細比較

模式行為適用場景
None關閉自動完成不需要
Suggest顯示下拉清單供選擇,不自動填入文字方塊選項多、使用者需確認
Append自動在文字方塊補全第一個符合項目,不顯示下拉輸入速度優先、選項少
SuggestAppend**同時**顯示下拉清單**並**自動補全文字方塊 (推薦)大多數情況

進階技巧

大小寫不敏感比對 (預設即為不敏感)

若需**大小寫敏感**,無內建屬性,需自訂 `AutoCompleteCustomSource` 並處理 `TextUpdate` 事件自行過濾 (複雜,不建議)。

動態更新來源 (搜尋建議、AJAX 風格)

private async void comboBox1_TextUpdate(object sender, EventArgs e)
{
    if (comboBox1.Text.Length < 2) return; // 至少 2 字元才查詢
    
    var suggestions = await SearchApiAsync(comboBox1.Text); // 回傳 List
    var source = new AutoCompleteStringCollection();
    source.AddRange(suggestions.ToArray());
    comboBox1.AutoCompleteCustomSource = source;
}

搭配 DataSource (繫結物件集合) 時的顯示成員

comboBox1.DataSource = products; // List
comboBox1.DisplayMember = "Name";
comboBox1.ValueMember = "Id";

// 自動完成需額外設定 CustomSource (DataSource 不支援 AutoCompleteSource.ListItems)
var names = products.Select(p => p.Name).ToArray();
comboBox1.AutoCompleteCustomSource.AddRange(names);
comboBox1.AutoCompleteSource = AutoCompleteSource.CustomSource;
comboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;

WPF 版本 (ComboBox.IsTextSearchEnabled)

<ComboBox ItemsSource="{Binding Products}" 
          DisplayMemberPath="Name"
          IsTextSearchEnabled="True" 
          IsEditable="True"
          StaysOpenOnEdit="True" />

WPF 原生支援文字搜尋 (前綴比對),不支援任意子字串搜尋。需模糊搜尋請用第三方控制項 (如 `MaterialDesignThemes` `ComboBox` + `TextSearch`)。

copyright © 萬盛學電腦網 all rights reserved