WPF中如何为禁用状态的TextBox设置专属默认显示文本

WPF实现这个需求最合理的方式是通过视觉层叠加提示文本实现，核心原则是不修改TextBox本身的Text属性值，避免污染原有绑定的业务数据，下面是两种可直接落地的实现：

方案1：局部场景使用（无额外C#代码，仅XAML样式实现） #

如果只有少量控件需要该效果，直接重写控件模板加触发器即可，不需要单独写附加逻辑。
注意：不要直接在触发器中修改TextBox的Text属性，否则会覆盖原有绑定的空值，导致控件重新启用后无法恢复原本的空状态，甚至反向污染绑定源数据

<!-- 引入到窗口/页面资源字典即可使用 -->
<Style TargetType="TextBox" x:Key="DisabledDefaultTextStyle">
    <!-- 用Tag存储默认文本，支持绑定自定义数据源 -->
    <Setter Property="Tag" Value="No data"/>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="TextBox">
                <Grid>
                    <!-- 原生TextBox基础结构，和系统默认外观一致 -->
                    <Border x:Name="Border" 
                            Background="{TemplateBinding Background}"
                            BorderBrush="{TemplateBinding BorderBrush}"
                            BorderThickness="{TemplateBinding BorderThickness}"
                            SnapsToDevicePixels="True">
                        <ScrollViewer x:Name="PART_ContentHost"
                                      Focusable="False"
                                      HorizontalScrollBarVisibility="Hidden"
                                      VerticalScrollBarVisibility="Hidden"/>
                    </Border>
                    <!-- 叠加的默认提示文本层，不影响实际Text值 -->
                    <TextBlock x:Name="DefaultTextHost"
                               Text="{TemplateBinding Tag}"
                               Margin="4,0"
                               VerticalAlignment="Center"
                               Foreground="{DynamicResource {x:Static SystemColors.GrayTextBrushKey}}"
                               Visibility="Collapsed"/>
                </Grid>
                <ControlTemplate.Triggers>
                    <!-- 触发条件：禁用状态 + 文本为空字符串 -->
                    <MultiTrigger>
                        <MultiTrigger.Conditions>
                            <Condition Property="IsEnabled" Value="False"/>
                            <Condition Property="Text" Value=""/>
                        </MultiTrigger.Conditions>
                        <Setter TargetName="DefaultTextHost" Property="Visibility" Value="Visible"/>
                    </MultiTrigger>
                    <!-- 触发条件：禁用状态 + 文本为null -->
                    <MultiTrigger>
                        <MultiTrigger.Conditions>
                            <Condition Property="IsEnabled" Value="False"/>
                            <Condition Property="Text" Value="{x:Null}"/>
                        </MultiTrigger.Conditions>
                        <Setter TargetName="DefaultTextHost" Property="Visibility" Value="Visible"/>
                    </MultiTrigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

使用时直接给目标TextBox指定样式即可：

<TextBox Style="{StaticResource DisabledDefaultTextStyle}" Tag="自定义默认文本"/>

方案2：全局复用（附加属性实现，适配全项目） #

如果项目中大量控件需要该效果，通过附加属性实现可以做到一次编码全局生效，不需要每个控件单独重写模板。
首先编写附加属性逻辑：

public static class TextBoxHelper
{
    public static readonly DependencyProperty DisabledDefaultTextProperty = DependencyProperty.RegisterAttached(
        "DisabledDefaultText",
        typeof(string),
        typeof(TextBoxHelper),
        new PropertyMetadata(default(string), OnDefaultTextChanged));

    public static void SetDisabledDefaultText(DependencyObject element, string value)
        => element.SetValue(DisabledDefaultTextProperty, value);

    public static string GetDisabledDefaultText(DependencyObject element)
        => (string)element.GetValue(DisabledDefaultTextProperty);

    private static void OnDefaultTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not TextBox textBox) return;
        // 注销旧事件避免内存泄漏
        textBox.IsEnabledChanged -= UpdateTextState;
        textBox.TextChanged -= UpdateTextState;
        // 注册状态更新事件
        textBox.IsEnabledChanged += UpdateTextState;
        textBox.TextChanged += UpdateTextState;

        // 首次加载时注入提示文本层
        textBox.Loaded += (_, _) =>
        {
            if (textBox.Resources.Contains("TextHost")) return;
            var placeholder = new TextBlock
            {
                Foreground = SystemColors.GrayTextBrush,
                Margin = new Thickness(4, 0, 0, 0),
                VerticalAlignment = VerticalAlignment.Center,
                Visibility = Visibility.Collapsed
            };
            placeholder.SetBinding(TextBlock.TextProperty, new Binding
            {
                Source = textBox,
                Path = new PropertyPath(DisabledDefaultTextProperty)
            });
            // 将提示层添加到父容器，和TextBox同位置叠加
            if (VisualTreeHelper.GetParent(textBox) is Grid parent)
            {
                Grid.SetColumn(placeholder, Grid.GetColumn(textBox));
                Grid.SetRow(placeholder, Grid.GetRow(textBox));
                parent.Children.Add(placeholder);
                textBox.Resources.Add("TextHost", placeholder);
                UpdateTextState(textBox, EventArgs.Empty);
            }
        };
        UpdateTextState(textBox, EventArgs.Empty);
    }

    private static void UpdateTextState(object sender, EventArgs e)
    {
        if (sender is not TextBox textBox) return;
        if (textBox.Resources["TextHost"] is not TextBlock placeholder) return;
        // 判断是否满足显示条件：禁用 + 文本为空
        bool shouldShow = !textBox.IsEnabled && string.IsNullOrEmpty(textBox.Text);
        placeholder.Visibility = shouldShow ? Visibility.Visible : Visibility.Collapsed;
    }
}

全局生效只需要在App.xaml中给TextBox默认样式加一个属性赋值即可：

<Application.Resources>
    <Style TargetType="TextBox">
        <Setter Property="local:TextBoxHelper.DisabledDefaultText" Value="No data"/>
    </Style>
</Application.Resources>

单个控件需要自定义默认文本时，直接在控件上声明属性即可，支持绑定业务数据源：

<TextBox local:TextBoxHelper.DisabledDefaultText="{Binding CustomTipText}"/>

实现说明 #

• 叠加层的实现方式完全不干扰原有输入、绑定、校验逻辑，是WPF实现这类占位提示的标准做法
• 如果后续需要扩展为启用状态也显示空值水印，只需要调整触发判断逻辑，去掉IsEnabled == False的条件即可
• 可以根据项目主题自定义提示文本的颜色、边距、字体样式，和整体UI保持一致

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