MAUI中如何从父页面访问ControlTemplate的子控件？

问题核心 #

你遇到的OnApplyTemplate未触发的原因是：你重写的是ContentPage的OnApplyTemplate，但实际应用ControlTemplate的是ContentView。ContentPage本身没有绑定模板，所以它的OnApplyTemplate不会被调用。要访问模板内的label1和label2，需要监听ContentView的模板应用事件，或自定义ContentView来处理模板切换。

解决方案一：监听ContentView的TemplateApplied事件 #

先给XAML中的ContentView命名，然后在后台绑定TemplateApplied事件，在事件触发时通过GetTemplateChild获取控件：

修改TestPage.xaml

给ContentView添加x:Name：

<ContentView x:Name="MyContentView">
    <ContentView.Triggers>
        <DataTrigger  TargetType="ContentView" Binding="{Binding MyCondition}" Value="True">
            <Setter Property="ControlTemplate" Value="{StaticResource view1}"/>
        </DataTrigger>
        <DataTrigger TargetType="ContentView" Binding="{Binding MyCondition}" Value="False">
            <Setter Property="ControlTemplate" Value="{StaticResource view2}"/>
        </DataTrigger>
    </ContentView.Triggers>
</ContentView>

修改TestPage.cs

在构造函数中绑定TemplateApplied事件，事件内获取控件：

public partial class TestPage : ContentPage
{
    private Label _currentLabel;

    public TestPage()
    {
        InitializeComponent();
        BindingContext = new MainPageViewModel();
        
        // 绑定模板应用完成事件
        MyContentView.TemplateApplied += MyContentView_TemplateApplied;
    }

    private void MyContentView_TemplateApplied(object sender, EventArgs e)
    {
        // 根据当前模板获取对应的Label
        var view1Label = MyContentView.GetTemplateChild("label1") as Label;
        var view2Label = MyContentView.GetTemplateChild("label2") as Label;
        
        _currentLabel = view1Label ?? view2Label;
        
        // 这里可以对label做操作，比如修改文本、绑定事件等
        if (_currentLabel != null)
        {
            // 示例：添加点击事件
            _currentLabel.GestureRecognizers.Add(new TapGestureRecognizer
            {
                Command = new Command(() => Console.WriteLine($"Clicked label: {_currentLabel.Text}"))
            });
        }
    }
}

解决方案二：自定义ContentView重写OnApplyTemplate #

如果需要更灵活的模板控件管理，可以自定义一个ContentView子类，重写它的OnApplyTemplate方法，每次模板切换时都会触发：

自定义ContentView类

public class CustomContentView : ContentView
{
    public event EventHandler<Label> LabelLoaded;

    protected override void OnApplyTemplate()
    {
        base.OnApplyTemplate();
        
        var label1 = GetTemplateChild("label1") as Label;
        var label2 = GetTemplateChild("label2") as Label;
        
        var loadedLabel = label1 ?? label2;
        LabelLoaded?.Invoke(this, loadedLabel);
    }
}

修改TestPage.xaml

引用自定义ContentView并替换原有的ContentView：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:TestApp"
             x:Class="TestApp.TestPage">

    <ContentPage.Resources>
        <ControlTemplate x:Key="view1">
            <Label Text="Hello from view 1" x:Name="label1"/>
        </ControlTemplate>

        <ControlTemplate x:Key="view2">
            <Label Text="Hello from view 2" x:Name="label2"/>
        </ControlTemplate>
    </ContentPage.Resources>

    <!-- 使用自定义ContentView -->
    <local:CustomContentView x:Name="MyCustomContentView">
        <local:CustomContentView.Triggers>
            <DataTrigger  TargetType="ContentView" Binding="{Binding MyCondition}" Value="True">
                <Setter Property="ControlTemplate" Value="{StaticResource view1}"/>
            </DataTrigger>
            <DataTrigger TargetType="ContentView" Binding="{Binding MyCondition}" Value="False">
                <Setter Property="ControlTemplate" Value="{StaticResource view2}"/>
            </DataTrigger>
        </local:CustomContentView.Triggers>
    </local:CustomContentView>
</ContentPage>

修改TestPage.cs

监听自定义ContentView的LabelLoaded事件：

public partial class TestPage : ContentPage
{
    private Label _currentLabel;

    public TestPage()
    {
        InitializeComponent();
        BindingContext = new MainPageViewModel();
        
        MyCustomContentView.LabelLoaded += MyCustomContentView_LabelLoaded;
    }

    private void MyCustomContentView_LabelLoaded(object sender, Label e)
    {
        _currentLabel = e;
        // 这里处理label的逻辑
        Console.WriteLine($"Loaded label: {_currentLabel.Text}");
    }
}

注意事项 #

• 每次切换ControlTemplate时，TemplateApplied事件或OnApplyTemplate都会重新触发，所以每次都能获取到当前模板的控件。
• GetTemplateChild只能获取到模板内使用x:Name定义的控件，注意名称拼写要完全一致。

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