如何监听ContentPresenter/ContentControl的DataTemplate加载事件且无需重复代码

核心问题说明 #

你之前重写OnContentTemplateChanged不触发的原因是：当使用ContentTemplateSelector动态选择模板时，WPF不会更新ContentTemplate依赖属性的值，因此对应变更事件不会触发。

方案1：使用附加属性（附加行为）全局捕获模板加载事件 #

该方案无需修改现有任何DataTemplate的内部代码，一次配置全局生效：

1. 首先定义附加属性类，自动挂钩所有目标元素的Loaded事件：

public static class DataTemplateLoadHook
{
    public static readonly DependencyProperty NotifyOnLoadedProperty = DependencyProperty.RegisterAttached(
        "NotifyOnLoaded", typeof(bool), typeof(DataTemplateLoadHook), new PropertyMetadata(false, OnNotifyOnLoadedChanged));

    private static void OnNotifyOnLoadedChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not FrameworkElement element) return;
        
        if ((bool)e.NewValue)
            element.Loaded += OnTemplateRootLoaded;
        else
            element.Loaded -= OnTemplateRootLoaded;
    }

    private static void OnTemplateRootLoaded(object sender, RoutedEventArgs e)
    {
        var loadedElement = (FrameworkElement)sender;
        // 向上查找对应的ContentControl/ContentPresenter
        var parentContentControl = FindVisualParent<ContentControl>(loadedElement);
        if (parentContentControl == null) return;
        
        // 此处写入你原来要在Grid_Loaded中执行的逻辑
        // 可以通过parentContentControl.Content、loadedElement.DataContext拿到对应数据
    }

    // 辅助查找可视化父元素的方法
    private static T FindVisualParent<T>(DependencyObject child) where T : DependencyObject
    {
        var parent = VisualTreeHelper.GetParent(child);
        if (parent == null) return null;
        return parent is T typedParent ? typedParent : FindVisualParent<T>(parent);
    }

    public static void SetNotifyOnLoaded(DependencyObject element, bool value) => element.SetValue(NotifyOnLoadedProperty, value);
    public static bool GetNotifyOnLoaded(DependencyObject element) => (bool)element.GetValue(NotifyOnLoadedProperty);
}

2. 在资源字典中添加全局样式，自动给所有DataTemplate的根元素附加该属性：

<ResourceDictionary>
    <Style TargetType="FrameworkElement">
        <Setter Property="local:DataTemplateLoadHook.NotifyOnLoaded" Value="True"/>
    </Style>

    <!-- 原有DataTemplate不需要做任何修改 -->
    <my:DetailViewDataTemplateSelector x:Key="myDataTemplateSelector"/>
    <DataTemplate x:Key="Template1"><!-- 原有内容 --></DataTemplate>
    <DataTemplate x:Key="Template2"><!-- 原有内容 --></DataTemplate>
    <DataTemplate x:Key="BlankDataTemplate" />
</ResourceDictionary>

方案2：自定义ContentControl监听内容加载完成 #

该方案仅需替换原有ContentPresenter，不需要修改DataTemplate：

1. 自定义ContentControl，监听Content变更后等布局完成再执行逻辑：

public class CustomContentControl : ContentControl
{
    protected override void OnContentChanged(object oldContent, object newContent)
    {
        base.OnContentChanged(oldContent, newContent);
        // 等待布局渲染完成，确保模板已经加载完毕
        Dispatcher.BeginInvoke(DispatcherPriority.Loaded, new Action(() =>
        {
            if (VisualTreeHelper.GetChildrenCount(this) == 0) return;
            var templateRoot = VisualTreeHelper.GetChild(this, 0) as FrameworkElement;
            if (templateRoot == null) return;
            
            // 此处写入你需要执行的逻辑
        }));
    }
}

2. 替换XAML中的ContentPresenter：

<local:CustomContentControl 
    ContentTemplateSelector="{StaticResource myDataTemplateSelector}" 
    Content="{Binding MyViewModelProperty}" />

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