.NET MAUI能否为不同页面配置独立Shell.SearchHandler？

可以为每个页面单独配置SearchHandler，问题核心在于Shell默认不会自动切换页面的SearchHandler，需要手动在页面切换时更新Shell的全局SearchHandler实例。

解决方案步骤 #

1. 为页面的SearchHandler添加命名 #

在每个页面的XAML中，给Shell.SearchHandler内的自定义SearchHandler添加x:Name属性，方便后台代码引用：

ContactsPage.xaml

<Shell.SearchHandler>
    <controls:ExternalContactSearchHandler x:Name="ExternalContactSearchHandler"
                              Placeholder="Enter last name"
                              ShowsResults="true"
                              ItemTemplate="{StaticResource ExternalContactSearchTemplate}"
                              ExternalContacts="{x:Static data:ExternalContactData.ExternalContacts}"
                              SelectedItemNavigationTarget="{x:Type views:ContactDetailPage}" />
</Shell.SearchHandler>

Users.xaml

<Shell.SearchHandler>
    <controls:UserSearchHandler x:Name="UserSearchHandler"
                              Placeholder="Enter User Name"
                              ShowsResults="true"
                              ItemTemplate="{StaticResource UserSearchTemplate}"
                              Users="{x:Static data:UserData.Users}"
                              SelectedItemNavigationTarget="{x:Type views:UserDetailPage}" />
</Shell.SearchHandler>

2. 在页面后台代码中更新Shell的SearchHandler #

重写每个页面的OnAppearing方法，将当前页面的SearchHandler赋值给Shell.Current.SearchHandler，确保页面显示时使用对应的搜索配置：

ContactsPage.xaml.cs

protected override void OnAppearing()
{
    base.OnAppearing();
    Shell.Current.SearchHandler = this.FindByName<ExternalContactSearchHandler>("ExternalContactSearchHandler");
}

Users.xaml.cs

protected override void OnAppearing()
{
    base.OnAppearing();
    Shell.Current.SearchHandler = this.FindByName<UserSearchHandler>("UserSearchHandler");
}

3. 确保自定义SearchHandler逻辑独立 #

自定义SearchHandler需正确继承自SearchHandler，并实现各自的搜索逻辑，比如重写OnQueryChanged处理搜索过滤，OnItemSelected处理导航：

ExternalContactSearchHandler示例

public class ExternalContactSearchHandler : SearchHandler
{
    public IList<ExternalContact> ExternalContacts { get; set; }
    public Type SelectedItemNavigationTarget { get; set; }

    protected override void OnQueryChanged(string oldValue, string newValue)
    {
        base.OnQueryChanged(oldValue, newValue);

        ItemsSource = string.IsNullOrWhiteSpace(newValue) 
            ? null 
            : ExternalContacts.Where(c => 
                c.FirstName.ToLower().Contains(newValue.ToLower()) ||
                c.LastName.ToLower().Contains(newValue.ToLower()))
                .ToList();
    }

    protected override async void OnItemSelected(object item)
    {
        base.OnItemSelected(item);
        if (SelectedItemNavigationTarget != null)
        {
            await Shell.Current.GoToAsync(SelectedItemNavigationTarget.FullName, 
                new Dictionary<string, object> { { "Contact", item as ExternalContact } });
        }
    }
}

UserSearchHandler示例

public class UserSearchHandler : SearchHandler
{
    public IList<User> Users { get; set; }
    public Type SelectedItemNavigationTarget { get; set; }

    protected override void OnQueryChanged(string oldValue, string newValue)
    {
        base.OnQueryChanged(oldValue, newValue);

        ItemsSource = string.IsNullOrWhiteSpace(newValue) 
            ? null 
            : Users.Where(u => u.Name.ToLower().Contains(newValue.ToLower()))
                .ToList();
    }

    protected override async void OnItemSelected(object item)
    {
        base.OnItemSelected(item);
        if (SelectedItemNavigationTarget != null)
        {
            await Shell.Current.GoToAsync(SelectedItemNavigationTarget.FullName, 
                new Dictionary<string, object> { { "User", item as User } });
        }
    }
}

4. 检查全局资源配置 #

确认App.xaml中的DataTemplate处于Application.Resources节点下（全局可访问），确保页面能正确引用StaticResource模板。

原理说明 #

MAUI Shell的SearchHandler默认是全局实例，页面切换时不会自动替换为当前页面的SearchHandler。通过在页面OnAppearing时手动赋值，强制Shell使用当前页面的搜索配置（包括模板、占位符和搜索逻辑），从而实现每个页面的独立搜索功能。

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