WPF中GetTemplateChild始终返回Null问题求助

我自定义了PanelItemBase控件，在Generic.xaml中定义了其样式与模板，但在重写的OnApplyTemplate方法中调用GetTemplateChild获取PART_pathBase和PART_grid时，始终返回Null。

模板代码（Generic.xaml） #

<Style TargetType="{x:Type local:PanelItemBase}"
       BasedOn="{StaticResource {x:Type ContentControl}}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:PanelItemBase}">
                <Grid   x:Name="PART_grid"
                        Width="{Binding Width, RelativeSource={RelativeSource TemplatedParent}}"
                        Height="{Binding Height, RelativeSource={RelativeSource TemplatedParent}}">
                    <local:PathBase x:Name="PART_pathBase"
                                    Content="{Binding Content, RelativeSource={RelativeSource TemplatedParent}}"
                                    Width="{Binding Width, RelativeSource={RelativeSource TemplatedParent}}"
                                    Height="{Binding Height, RelativeSource={RelativeSource TemplatedParent}}"
                                    CornerRadius="{Binding CornerRadius, RelativeSource={RelativeSource TemplatedParent}}"
                                    Fill="{Binding Fill, RelativeSource={RelativeSource TemplatedParent}}"
                                    Stroke="{Binding Stroke, RelativeSource={RelativeSource TemplatedParent}}"
                                    StrokeThickness="{Binding StrokeThickness, RelativeSource={RelativeSource TemplatedParent}}"
                                    Shadow="{Binding Shadow, RelativeSource={RelativeSource TemplatedParent}}"
                                    ShadowDepth="{Binding ShadowDepth, RelativeSource={RelativeSource TemplatedParent}}"
                                    ShadowDistance="{Binding ShadowDistance, RelativeSource={RelativeSource TemplatedParent}}"/>
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

后台代码 #

public override void OnApplyTemplate()
{
    base.OnApplyTemplate();
    
    _pathBase = GetTemplateChild("PART_pathBase") as PathBase;
    if (_pathBase == null) Debug.WriteLine("PART_pathBase not found in PanelItemBase template.");
    else Debug.WriteLine("PART_pathBase successfully retrieved.");
    
    _grid = GetTemplateChild("PART_grid") as Grid;
    if (_grid == null) Debug.WriteLine("PART_grid not found in PanelItemBase template.");
    else Debug.WriteLine("PART_grid successfully retrieved.");
}

已尝试操作：

• 隔离问题（单独测试该控件）
• 验证Generic.xaml已正确应用
• 创建相同配置的新文件

解决建议 #

1. 添加TemplatePart特性
   必须在PanelItemBase类上标注TemplatePart特性，明确声明模板部件的名称和对应类型，WPF才能正确识别并允许通过GetTemplateChild获取：

   [TemplatePart(Name = "PART_grid", Type = typeof(Grid))]
   [TemplatePart(Name = "PART_pathBase", Type = typeof(PathBase))]
   public class PanelItemBase : ContentControl
   {
       // 类的其他实现代码
   }
   

2. 确认默认样式绑定
   在PanelItemBase的构造函数中显式设置默认样式键，确保模板能被正确加载：

   public PanelItemBase()
   {
       DefaultStyleKey = typeof(PanelItemBase);
   }
   

   同时检查Generic.xaml的生成操作是否设置为Resource，避免资源无法被加载。

3. 排查样式覆盖问题
   检查是否存在其他针对ContentControl或PanelItemBase的隐式样式，可能会覆盖当前模板。可以通过显式指定控件样式来测试：

   <local:PanelItemBase Style="{StaticResource {x:Type local:PanelItemBase}}" />
   

4. 延迟获取部件
   若模板存在加载延迟，可在Loaded事件中再次尝试获取部件：

   public PanelItemBase()
   {
       Loaded += (s, e) =>
       {
           _pathBase = GetTemplateChild("PART_pathBase") as PathBase;
           _grid = GetTemplateChild("PART_grid") as Grid;
           // 后续逻辑处理
       };
   }
   

5. 验证命名空间与类型匹配
   确认XAML中local:命名空间与后台代码的命名空间完全一致，PathBase的类型拼写无误，避免因类型不匹配导致转换失败。

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