MAUI中OnTapped事件无法使用TappedEventArgs的问题求助

API 探路者

2026-8-2

MAUI TapGestureRecognizer事件参数匹配问题解决

问题原因

你遇到的CS0123错误，核心是事件处理函数的参数类型与TapGestureRecognizer.Tapped事件的委托类型不匹配，大概率是以下两种情况：

未引用正确的命名空间，导致TappedEventArgs不是MAUI框架的对应类型
事件绑定方式错误，使用了非泛型的EventHandler委托

解决方案

1. 确认命名空间引用

确保代码文件顶部添加MAUI控件的专属命名空间，避免其他框架同名类干扰：

using Microsoft.Maui.Controls;

2. 正确的事件处理写法

XAML绑定示例

<Label Text="点击测试">
    <Label.GestureRecognizers>
        <TapGestureRecognizer Tapped="OnTapHandler" />
    </Label.GestureRecognizers>
</Label>

C#事件处理函数

private void OnTapHandler(object sender, TappedEventArgs args)
{
    // 获取点击相对控件的位置
    var position = args.GetPosition((View)sender);
    if (position.HasValue)
    {
        double x = position.Value.X;
        double y = position.Value.Y;
        // 此处添加你的点击位置处理逻辑
    }
}

C#代码绑定事件示例

如果手动创建TapGestureRecognizer，确保绑定泛型委托：

var tapGesture = new TapGestureRecognizer();
// 编译器自动推断委托类型为EventHandler<TappedEventArgs>
tapGesture.Tapped += OnTapHandler;

yourView.GestureRecognizers.Add(tapGesture);