WPF C#：如何访问自定义控件的子元素？

嗨，刚好我对WPF自定义控件这块熟得很，给你几个实用的解决方案，分情况来看：

1. 最规范的做法：重写OnApplyTemplate + Template.FindName #

如果你的子元素是定义在控件模板（也就是Generic.xaml里的ControlTemplate）中的，这是最靠谱的方式。因为控件模板是在OnApplyTemplate方法调用后才真正应用到控件上的，这时候才能准确获取到模板内的元素。

首先，先在你的Generic.xaml里给目标子元素起个带PART_前缀的名字（这是WPF控件开发的规范，用来标识控件功能依赖的关键子元素）：

<ControlTemplate TargetType="{x:Type local:testcontrol}">
    <Grid>
        <!-- 给子元素命名，用PART_前缀 -->
        <TextBox x:Name="PART_InputTextBox" />
    </Grid>
</ControlTemplate>

然后在自定义控件的C#代码里，重写OnApplyTemplate方法来获取这个子元素：

public class testcontrol : Control
{
    private TextBox _inputTextBox;

    public override void OnApplyTemplate()
    {
        // 先调用基类方法确保模板加载完成
        base.OnApplyTemplate();

        // 从模板中查找指定名称的子元素
        _inputTextBox = Template.FindName("PART_InputTextBox", this) as TextBox;

        if (_inputTextBox != null)
        {
            // 这里就可以操作这个子元素了，比如绑定事件、修改属性
            _inputTextBox.TextChanged += InputTextBox_TextChanged;
        }
    }

    private void InputTextBox_TextChanged(object sender, TextChangedEventArgs e)
    {
        // 这里写你的业务逻辑
    }
}

2. 直接访问UserControl的子元素（仅限UserControl） #

如果你是基于UserControl开发的自定义控件，而且子元素直接写在UserControl的XAML里（不是模板中），那只要给子元素加x:Name，就能在代码后台直接访问：

<!-- MyUserControl.xaml -->
<UserControl ...>
    <Grid>
        <Button x:Name="MyActionButton" Content="点击" />
    </Grid>
</UserControl>

// MyUserControl.xaml.cs
public MyUserControl()
{
    InitializeComponent();
    // 直接通过名称访问子元素
    MyActionButton.Click += MyActionButton_Click;
}

private void MyActionButton_Click(object sender, RoutedEventArgs e)
{
    // 处理点击逻辑
}

3. 不推荐的方法：遍历可视化树 #

如果你实在没办法用前面两种方法（不建议），可以写个辅助方法遍历可视化树来查找子元素，但这种方法耦合性极高，只要模板结构一变代码就会失效：

// 辅助方法：递归查找可视化树中的子元素
public static T FindVisualChild<T>(DependencyObject parent) where T : DependencyObject
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        var child = VisualTreeHelper.GetChild(parent, i);
        if (child is T targetElement)
            return targetElement;

        var nestedChild = FindVisualChild<T>(child);
        if (nestedChild != null)
            return nestedChild;
    }
    return null;
}

调用方式：

// 在模板加载完成后调用（比如OnApplyTemplate里）
var targetTextBox = FindVisualChild<TextBox>(this);
if (targetTextBox != null)
{
    // 操作元素
}

注意事项 #

• 绝对不要在控件的构造函数里直接查找模板内的子元素，这时候模板还没加载，肯定会返回null。
• 优先用PART_前缀+OnApplyTemplate的方式，符合WPF的设计规范，代码也更稳定。

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