MAUI中XAML Flyout Menu的C#等效实现：NavigationBar属性编译问题

在.NET 7 MAUI环境下将AppShell.XAML的Flyout菜单转为C#代码实现时，设置NavigationPage.HasNavigationBar附加属性会出现编译失败，以下是原XAML代码和问题代码示例：

原XAML代码 #

<FlyoutItem FlyoutDisplayOptions="AsMultipleItems"  >
    <Tab Title="Home" Icon="home.png" >
        <ShellContent Title="Disclaimer" 
                      ContentTemplate="{DataTemplate views:DisclaimerPage}" 
                      NavigationPage.HasNavigationBar="True" 
                      Route="MainPage" />
    </Tab>
    <Tab Title="Downloads" Icon="downloads.png">
        <ShellContent Title="Downloads" 
                      ContentTemplate="{DataTemplate views:DisclaimerPage}" 
                      NavigationPage.HasNavigationBar="False" 
                      Route="MainPage" />
    </Tab>
    <Tab Title="Search" Icon="search.png">
        <ShellContent Title="Disclaimer" 
                      ContentTemplate="{DataTemplate views:DisclaimerPage}" 
                      NavigationPage.HasNavigationBar="False" 
                      Route="MainPage" />
    </Tab>
    <Tab Title="About" Icon="info_circle.png">
        <ShellContent Title="About"
                      ContentTemplate="{DataTemplate views:AboutPage}"
                      NavigationPage.HasNavigationBar="False"
                      Route="AboutView"/>
    </Tab>
</FlyoutItem>

问题代码的错误点 #

待修复代码中NavigationPage.HasNavigationBar="False"的写法不符合C#中附加属性的赋值规则，这是导致编译失败的核心原因。

问题原因 #

NavigationPage.HasNavigationBar是MAUI中的附加属性，在XAML中可以通过附加类名.属性名的方式赋值，但在C#代码中，必须使用对应的静态方法或SetValue方法来设置，不能像普通属性那样直接在对象初始化器中赋值。

修复后的完整C#代码 #

_tabs = new ObservableCollection<Tab>()
{
    // Home标签（对应NavigationBar=True）
    new Tab
    {
        Title = "Home",
        Icon = "home.png",
        Items =
        {
            new ShellContent
            {
                ContentTemplate = new DataTemplate(typeof(DisclaimerPage)),
                Route = nameof(DisclaimerPage),
                Title = "Disclaimer"
            }
        }
    },
    // Downloads标签（对应NavigationBar=False）
    new Tab
    {
        Title = "Downloads",
        Icon = "downloads.png",
        Items =
        {
            new ShellContent
            {
                ContentTemplate = new DataTemplate(typeof(DisclaimerPage)),
                Route = nameof(DisclaimerPage),
                Title = "Downloads"
            }
        }
    },
    // Search标签（对应NavigationBar=False）
    new Tab
    {
        Title = "Search",
        Icon = "search.png",
        Items =
        {
            new ShellContent
            {
                ContentTemplate = new DataTemplate(typeof(DisclaimerPage)),
                Route = nameof(DisclaimerPage),
                Title = "Disclaimer"
            }
        }
    },
    // About标签（对应NavigationBar=False）
    new Tab
    {
        Title = "About",
        Icon = "info_circle.png",
        Items =
        {
            new ShellContent
            {
                ContentTemplate = new DataTemplate(typeof(AboutPage)),
                Route = nameof(AboutPage),
                Title = "About"
            }
        }
    }
};

// 为每个ShellContent设置附加属性
if (_tabs.FirstOrDefault(t => t.Title == "Home")?.Items.FirstOrDefault() is ShellContent homeShell)
{
    NavigationPage.SetHasNavigationBar(homeShell, true);
}

if (_tabs.FirstOrDefault(t => t.Title == "Downloads")?.Items.FirstOrDefault() is ShellContent downloadsShell)
{
    NavigationPage.SetHasNavigationBar(downloadsShell, false);
}

if (_tabs.FirstOrDefault(t => t.Title == "Search")?.Items.FirstOrDefault() is ShellContent searchShell)
{
    NavigationPage.SetHasNavigationBar(searchShell, false);
}

if (_tabs.FirstOrDefault(t => t.Title == "About")?.Items.FirstOrDefault() is ShellContent aboutShell)
{
    NavigationPage.SetHasNavigationBar(aboutShell, false);
}

简化写法（初始化时直接设置） #

也可以在创建ShellContent实例时，直接通过SetValue方法设置附加属性，省去后续单独设置的步骤：

new ShellContent
{
    ContentTemplate = new DataTemplate(typeof(DisclaimerPage)),
    Route = nameof(DisclaimerPage),
    Title = "Disclaimer"
}.SetValue(NavigationPage.HasNavigationBarProperty, true);

补充说明 #

• 所有MAUI附加属性都遵循此规则：必须通过[附加类].Set[属性名]静态方法或SetValue([附加类].[属性名]Property, 值)的方式赋值。
• 代码中补全了原XAML中缺失的Title属性和Downloads标签，保证与原XAML功能完全一致。

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