.NET MAUI Entry验证不通过时，如何取消Enter键自动跳转下一项的行为？

我们在实现简单表单时，对.NET MAUI Entry控件的输入值做验证：输入有效时不做操作；无效时希望保持当前字段焦点并高亮红色。但因为把Enter键的行为设为了NEXT，在Completed事件方法里设置焦点后，自动跳转到下一项的行为还是会触发，怎么取消这个默认跳转？

用户原代码：

public void control_entry_complete(object sender, EventArgs e)
{

    try
    {
        bool_result = is_field_value_valid(pattern, value);
        if (!bool_result)
        {
            trx.set_focus(((View)sender).StyleId);
            return;
        //LOOKS LIKE FOCUS IS SET TO NEXT FIELD AFTER THIS RETURN!?!?
        }
    }
    catch (Exception ex)
    {
        Globals.log.add(ex);
    }
}

解决思路和实现方案 #

核心就是拦截默认的Enter键跳转行为，完全自己控制焦点流转，不要依赖MAUI自带的NEXT自动跳转逻辑。

方案一：修改Completed事件方法，延迟设置焦点

默认的跳转行为可能在Completed事件执行之后才触发，加个小延迟就能确保我们的焦点设置覆盖默认行为：

public async void control_entry_complete(object sender, EventArgs e)
{
    try
    {
        var currentEntry = sender as Entry;
        bool isValid = is_field_value_valid(pattern, currentEntry.Text);
        
        if (!isValid)
        {
            // 高亮红色，比如设置边框颜色
            currentEntry.BorderColor = Colors.Red;
            // 延迟10毫秒后设置焦点，覆盖默认跳转
            await Task.Delay(10);
            currentEntry.Focus();
            return;
        }
        
        // 验证通过，恢复正常样式
        currentEntry.BorderColor = Colors.Gray;
        // 如果需要手动跳转到下一个字段，在这里自己处理
        // 比如找到下一个Entry控件并调用Focus()
    }
    catch (Exception ex)
    {
        Globals.log.add(ex);
    }
}

方案二：用ReturnCommand替代Completed事件

直接给Entry绑定ReturnCommand，完全掌控Enter键的行为，彻底绕过默认跳转：

// 在页面构造函数或控件初始化时绑定命令
var yourEntry = this.FindByName<Entry>("YourEntryId");
yourEntry.ReturnCommand = new Command(() =>
{
    bool isValid = is_field_value_valid(pattern, yourEntry.Text);
    
    if (!isValid)
    {
        yourEntry.BorderColor = Colors.Red;
        yourEntry.Focus();
    }
    else
    {
        yourEntry.BorderColor = Colors.Gray;
        // 手动指定下一个要聚焦的控件
        var nextEntry = this.FindByName<Entry>("NextEntryId");
        nextEntry?.Focus();
    }
});

方案三：自定义Entry控件（最彻底）

如果上述方案还是有问题，可以自定义Entry，重写OnCompleted方法，在验证不通过时不调用基类方法，直接阻止默认行为：

public class CustomEntry : Entry
{
    protected override void OnCompleted()
    {
        bool isValid = is_field_value_valid(/* 传入你的验证规则和当前文本 */);
        if (!isValid)
        {
            this.BorderColor = Colors.Red;
            this.Focus();
            // 不调用基类方法，阻止默认跳转
            return;
        }
        
        // 验证通过，执行基类逻辑或自己处理跳转
        base.OnCompleted();
    }
}

注意事项 #

• 不管用哪种方案，都建议自己控制焦点的移动，不要依赖MAUI自带的NEXT自动跳转，这样验证不通过时能完全保留当前焦点。
• 延迟设置焦点的时间不用太长，10-50毫秒足够覆盖默认跳转的执行时机。

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