.NET MAUI中如何通过XAML继承实现全局通用控件？

你遇到的样式问题（比如Label自动换行失效），根源在于后台代码直接替换并移动Content控件的方式破坏了子页面布局的上下文依赖。下面是更可靠的实现方案，通过XAML的ContentPresenter来承载子页面内容，避免布局异常：

1. 重新定义BasePage的XAML #

无需后台代码动态构建布局，直接在XAML中完成全局结构定义，用ContentPresenter自动承接子页面内容：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="foo.Views.BasePage">
    <Grid RowDefinitions="*,80">
        <!-- ContentPresenter 自动加载子页面设置的Content内容 -->
        <ContentPresenter Grid.Row="0" 
                          Content="{Binding Content, RelativeSource={RelativeSource AncestorType={x:Type ContentPage}}}" />
        <!-- 全局按钮 -->
        <Button Grid.Row="1" Text="全局按钮" />
    </Grid>
</ContentPage>

2. BasePage后台代码保持默认 #

不需要额外的Content替换逻辑，仅保留初始化代码即可：

namespace foo.Views;

public partial class BasePage : ContentPage
{
    public BasePage()
    {
        InitializeComponent();
    }
}

3. 子页面继承BasePage（沿用原有写法） #

你的MainPage可以继续使用原有的XAML结构，无需修改：

<views:BasePage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:views="clr-namespace:foo.Views"
             xmlns:viewModels="clr-namespace:foo.ViewModels"
             xmlns:converters="clr-namespace:foo.Converters"
             x:Class="foo.MainPage"
             NavigationPage.HasBackButton="False"
             Title="foo"
             Loaded="ContentPage_Loaded">

    <views:BasePage.Content>
         <Grid>
             <!-- 子页面内容，Label自动换行等样式可正常生效 -->
             <Label Text="这是一段用于测试自动换行的长文本，验证布局是否正常工作，确保内容不会出现截断或样式异常。"
                    LineBreakMode="WordWrap" />
         </Grid>
    </views:BasePage.Content>

</views:BasePage>

方案优势 #

ContentPresenter是MAUI中专门用于展示父级内容的控件，它会完整保留子页面Content的布局上下文、样式绑定和约束条件，不会像后台动态移动控件那样导致布局逻辑失效，从根源上解决Label换行异常这类问题。

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