如何让AutoSuggestBox仅允许选择ItemsSource中的有效文本？

我刚处理过几乎一模一样的需求，给你整理了一套完整的实现方案，涵盖输入验证、焦点锁定和自动匹配三个核心点，直接就能复用：

1. 拦截提交事件，先做合法性校验 #

首先要在QuerySubmitted事件里拦截用户的提交动作，判断输入内容是否在ItemsSource里。如果无效，就取消提交、尝试自动匹配最优项，同时锁定焦点。

private void AutoSuggestBox_QuerySubmitted(AutoSuggestBox sender, AutoSuggestBoxQuerySubmittedEventArgs args)
{
    // 用户手动选了列表项，直接走正常提交逻辑
    if (args.ChosenSuggestion != null)
    {
        HandleValidSelection(args.ChosenSuggestion);
        return;
    }

    var inputText = sender.Text.Trim();
    // 检查输入文本是否匹配ItemsSource中的项（替换YourDataType和DisplayProperty为你的实际类型/属性）
    var isValidInput = sender.ItemsSource.Cast<YourDataType>()
        .Any(item => item.DisplayProperty.Equals(inputText, StringComparison.OrdinalIgnoreCase));

    if (!isValidInput)
    {
        // 输入无效，阻止默认提交行为
        args.Handled = true;
        // 尝试自动匹配最相似的项
        AutoSelectBestMatch(sender);
        // 强制焦点回到输入框
        sender.Focus(FocusState.Programmatic);
    }
    else
    {
        // 输入有效，找到对应项并处理
        var matchedItem = sender.ItemsSource.Cast<YourDataType>()
            .First(item => item.DisplayProperty.Equals(inputText, StringComparison.OrdinalIgnoreCase));
        HandleValidSelection(matchedItem);
    }
}

2. 实现自动匹配最优项逻辑 #

这里用简单的前缀匹配示例，如果你需要更精准的模糊匹配，可以替换成Levenshtein距离之类的算法：

private void AutoSelectBestMatch(AutoSuggestBox autoSuggestBox)
{
    var inputText = autoSuggestBox.Text.Trim();
    if (string.IsNullOrEmpty(inputText)) return;

    // 找前缀匹配的第一个项
    var bestMatch = autoSuggestBox.ItemsSource.Cast<YourDataType>()
        .FirstOrDefault(item => item.DisplayProperty.StartsWith(inputText, StringComparison.OrdinalIgnoreCase));

    if (bestMatch != null)
    {
        // 自动选中并更新输入框文本
        autoSuggestBox.Text = bestMatch.DisplayProperty;
        autoSuggestBox.SelectedItem = bestMatch;
        // 触发有效提交逻辑
        HandleValidSelection(bestMatch);
    }
    // 没有匹配项的话，保持当前输入但锁定焦点
}

3. 锁定焦点直到满足允许转移的条件 #

仅靠提交事件不够，还要处理LostFocus事件，防止用户在输入无效时强行切换焦点：

private void AutoSuggestBox_LostFocus(object sender, RoutedEventArgs e)
{
    var autoSuggestBox = sender as AutoSuggestBox;
    var inputText = autoSuggestBox.Text.Trim();

    // 判断是否满足焦点可转移的三个条件之一
    var hasValidSelectedItem = autoSuggestBox.SelectedItem != null;
    var isTextCleared = string.IsNullOrEmpty(inputText);
    var isValidText = autoSuggestBox.ItemsSource.Cast<YourDataType>()
        .Any(item => item.DisplayProperty.Equals(inputText, StringComparison.OrdinalIgnoreCase));

    if (!hasValidSelectedItem && !isTextCleared && !isValidText)
    {
        // 不满足条件，强行把焦点拉回来
        autoSuggestBox.Focus(FocusState.Programmatic);
    }
}

4. 处理清除按钮的逻辑 #

AutoSuggestBox自带的"x"清除按钮会清空文本，这时候要允许焦点正常转移，在TextChanged事件里处理：

private void AutoSuggestBox_TextChanged(AutoSuggestBox sender, AutoSuggestBoxTextChangedEventArgs args)
{
    // 文本清空时，重置选中状态，允许焦点转移
    if (string.IsNullOrEmpty(sender.Text))
    {
        sender.SelectedItem = null;
    }
    // 如果是用户输入，实时过滤建议列表（可选，根据你的需求调整）
    else if (args.Reason == AutoSuggestionBoxTextChangeReason.UserInput)
    {
        sender.ItemsSource = GetFilteredSuggestions(sender.Text);
    }
}

5. 统一处理有效选择的业务逻辑 #

把有效项的处理逻辑抽成单独方法，避免代码重复：

private void HandleValidSelection(YourDataType selectedItem)
{
    // 这里写你的业务逻辑，比如执行搜索、导航到对应页面等
    Debug.WriteLine($"提交有效选项：{selectedItem.DisplayProperty}");
}

注意事项 #

• 把代码里的YourDataType替换成你实际的数据源类型，DisplayProperty替换成用来匹配显示的属性名
• 建议配合友好的提示（比如在输入框下方显示"请选择有效选项或清除输入"），避免用户困惑
• 如果你的ItemsSource是动态更新的，要确保过滤逻辑能实时同步

内容的提问来源于stack exchange，提问作者Bimo