WPF自定义GridedTBox控件：添加的TextBlock无法显示问题排查

你的核心错误在于选错了自定义控件的继承基类，且错误地让控件修改外部容器（父Grid）的结构，具体问题和修正方案如下：

错误原因拆解 #

1. 继承基类错误：你继承了TextBox，但TextBox是单一输入控件，而你需要的是包含标签和输入框的复合控件。让TextBox去修改父Grid的结构，违背了WPF控件的封装原则。
2. 事件时机与逻辑错误：OnApplyTemplate是用来初始化控件自身模板内部元素的方法，不是用来操作外部父容器的。此时父Grid可能还未完成布局计算，导致你添加的TextBlock尺寸计算异常；同时直接修改父Grid的列布局，会干扰容器原有逻辑，导致TextBox的列位置被意外覆盖。
3. 布局定义缺失：你添加TextBlock时，未确保父Grid已定义至少两列，也未给TextBlock设置必要的布局属性（如VerticalAlignment、Margin、列宽度），导致控件被压缩至尺寸为0。

正确实现方案 #

应该创建一个复合自定义控件，将标签和输入框封装在控件内部，而非修改外部容器。以下是两种可行方式：

方式1：使用UserControl（快速实现） #

直接创建包含Grid、TextBlock、TextBox的UserControl，简单直观：

<!-- LabeledTextBox.xaml -->
<UserControl x:Class="YourNamespace.LabeledTextBox"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="Auto" MinWidth="80"/> <!-- 标签列自动宽度，最小宽度保证对齐 -->
            <ColumnDefinition Width="*"/> <!-- 输入框占剩余空间 -->
        </Grid.ColumnDefinitions>
        <TextBlock Grid.Column="0" 
                   Text="{Binding Label, RelativeSource={RelativeSource AncestorType=UserControl}}"
                   VerticalAlignment="Center"
                   Margin="0,0,8,0"/>
        <TextBox Grid.Column="1" 
                 Text="{Binding Text, RelativeSource={RelativeSource AncestorType=UserControl}}"
                 VerticalAlignment="Center"/>
    </Grid>
</UserControl>

后台代码定义依赖属性：

// LabeledTextBox.xaml.cs
public partial class LabeledTextBox : UserControl
{
    public static readonly DependencyProperty LabelProperty =
        DependencyProperty.Register(nameof(Label), typeof(string), typeof(LabeledTextBox), new PropertyMetadata(string.Empty));

    public static readonly DependencyProperty TextProperty =
        DependencyProperty.Register(nameof(Text), typeof(string), typeof(LabeledTextBox), new PropertyMetadata(string.Empty));

    public LabeledTextBox() => InitializeComponent();

    public string Label
    {
        get => (string)GetValue(LabelProperty);
        set => SetValue(LabelProperty, value);
    }

    public string Text
    {
        get => (string)GetValue(TextProperty);
        set => SetValue(TextProperty, value);
    }
}

使用方式：

<Grid>
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto"/>
    </Grid.RowDefinitions>
    <local:LabeledTextBox Grid.Row="0" Label="Server" Text="{Binding FtpServer}"/>
</Grid>

方式2：自定义Control（更灵活，适合复用） #

继承Control并通过模板定义布局，适合需要高度定制样式的场景：
后台代码：

public class LabeledTextBox : Control
{
    public static readonly DependencyProperty LabelProperty =
        DependencyProperty.Register(nameof(Label), typeof(string), typeof(LabeledTextBox), new PropertyMetadata(string.Empty));

    public static readonly DependencyProperty TextProperty =
        DependencyProperty.Register(nameof(Text), typeof(string), typeof(LabeledTextBox), new PropertyMetadata(string.Empty));

    static LabeledTextBox()
    {
        DefaultStyleKeyProperty.OverrideMetadata(typeof(LabeledTextBox), new FrameworkPropertyMetadata(typeof(LabeledTextBox)));
    }

    public string Label
    {
        get => (string)GetValue(LabelProperty);
        set => SetValue(LabelProperty, value);
    }

    public string Text
    {
        get => (string)GetValue(TextProperty);
        set => SetValue(TextProperty, value);
    }
}

在Generic.xaml中定义默认模板：

<Style TargetType="{x:Type local:LabeledTextBox}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:LabeledTextBox}">
                <Grid>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="Auto" MinWidth="80"/>
                        <ColumnDefinition Width="*"/>
                    </Grid.ColumnDefinitions>
                    <TextBlock Grid.Column="0" 
                               Text="{TemplateBinding Label}"
                               VerticalAlignment="Center"
                               Margin="0,0,8,0"/>
                    <TextBox Grid.Column="1" 
                             Text="{TemplateBinding Text}"
                             VerticalAlignment="Center"/>
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

使用方式与UserControl完全一致。

总结 #

• 永远不要让控件修改自身的外部容器结构，复合控件的布局应该封装在控件内部。
• 优先选择UserControl快速实现复合控件，需要样式定制时再用自定义Control。
• 确保布局容器（如Grid）的列/行定义清晰，控件的对齐、边距属性设置合理，避免出现控件被压缩的情况。

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