如何在Android的.NET Maui中通过自定义控件移除SearchBar取消按钮？

核心思路 #

.NET Maui的SearchBar在Android平台对应的原生控件是SearchView，要移除取消按钮，需要通过自定义Handler（替代旧版Xamarin的渲染器）直接修改原生控件的属性。

步骤1：创建自定义SearchBar控件 #

先定义一个继承自SearchBar的自定义控件，作为标记供后续Handler识别：

namespace YourAppNamespace.Controls;

public class CustomSearchBar : SearchBar
{
    // 无需额外属性，仅作为自定义控件标识
}

步骤2：在Android项目中实现自定义Handler #

在Android平台项目下创建Handler子类，重写连接逻辑，获取原生SearchView并隐藏取消按钮：

using Android.Widget;
using Microsoft.Maui.Handlers;
using YourAppNamespace.Controls;

namespace YourAppNamespace.Platforms.Android.Handlers;

public class CustomSearchBarHandler : SearchBarHandler
{
    protected override void ConnectHandler(SearchView platformView)
    {
        base.ConnectHandler(platformView);
        
        // 让搜索框保持展开状态，避免折叠时出现取消按钮触发逻辑
        platformView.SetIconifiedByDefault(false);
        
        // 查找并隐藏右侧的取消按钮
        var cancelButton = platformView.FindViewById<ImageView>(Android.Resource.Id.SearchCloseButton);
        if (cancelButton != null)
        {
            cancelButton.Visibility = Android.Views.ViewStates.Gone;
        }
    }
}

步骤3：注册自定义Handler #

在MauiProgram.cs中注册自定义Handler，替换默认的SearchBar处理逻辑：

using YourAppNamespace.Controls;
using YourAppNamespace.Platforms.Android.Handlers;

namespace YourAppNamespace;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

        // 仅在Android平台注册自定义Handler
#if ANDROID
        builder.ConfigureMauiHandlers(handlers =>
        {
            handlers.AddHandler<CustomSearchBar, CustomSearchBarHandler>();
        });
#endif

        return builder.Build();
    }
}

步骤4：在XAML中使用自定义控件 #

引入自定义控件的命名空间，替换默认的SearchBar：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:controls="clr-namespace:YourAppNamespace.Controls"
             x:Class="YourAppNamespace.MainPage">

    <StackLayout Padding="16">
        <controls:CustomSearchBar Placeholder="请输入搜索内容..." />
    </StackLayout>
</ContentPage>

额外注意事项 #

• 确保命名空间与你的项目结构完全匹配，避免编译错误；
• 部分Android版本可能SearchCloseButton的ID有差异，若找不到控件，可尝试遍历SearchView的子视图查找取消按钮；
• SetIconifiedByDefault(false)会让搜索框始终处于展开状态，若需要保留折叠功能，可仅隐藏取消按钮，不设置此属性。

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