WinForms `ComboBox` 內建強大的自動完成功能,支援**下拉建議**、**自動補全**、**自訂資料來源**。本文詳細說明三種資料來源模式與進階技巧。
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);
}
}
// 先填入 Items
foreach (var name in GetAllUnitNames()) comboBox1.Items.Add(name);
// 直接指定來源為 Items
comboBox1.AutoCompleteSource = AutoCompleteSource.ListItems;
comboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
優點:不需額外集合。缺點:Items 過多 (超過 1000) 會影響下拉效能。
內建系統來源:檔案系統路徑、網址歷史、Shell 歷史。適用於路徑輸入、網址列。
comboBox1.AutoCompleteSource = AutoCompleteSource.FileSystem;
comboBox1.AutoCompleteMode = AutoCompleteMode.Suggest;
| 模式 | 行為 | 適用場景 |
|---|---|---|
None | 關閉自動完成 | 不需要 |
Suggest | 顯示下拉清單供選擇,不自動填入文字方塊 | 選項多、使用者需確認 |
Append | 自動在文字方塊補全第一個符合項目,不顯示下拉 | 輸入速度優先、選項少 |
SuggestAppend | **同時**顯示下拉清單**並**自動補全文字方塊 (推薦) | 大多數情況 |
若需**大小寫敏感**,無內建屬性,需自訂 `AutoCompleteCustomSource` 並處理 `TextUpdate` 事件自行過濾 (複雜,不建議)。
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;
}
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;
<ComboBox ItemsSource="{Binding Products}"
DisplayMemberPath="Name"
IsTextSearchEnabled="True"
IsEditable="True"
StaysOpenOnEdit="True" />
WPF 原生支援文字搜尋 (前綴比對),不支援任意子字串搜尋。需模糊搜尋請用第三方控制項 (如 `MaterialDesignThemes` `ComboBox` + `TextSearch`)。