WPF中ListBox与ListBoxItem内验证异常问题排查

核心原因 #

你遇到的问题大概率是ListBoxItem的默认Content绑定触发了整体对象验证，进而导致子控件（SourceIconColorButton）错误显示验证边框：

1. ListBoxItem的Content默认绑定到DataContext（即SourceItem），而该绑定的ValidatesOnNotifyDataErrors默认是True。
2. 当SourceItem的任意属性（比如Name）验证失败时，整个SourceItem的HasErrors为True，ListBoxItem的Content绑定会检测到对象级别的错误，导致ListBoxItem的Validation.HasError变为True。
3. 你的CustomExpander作为ListBoxItem的模板内容，继承了这个错误状态，而SourceIconColorButton的样式/模板没有显式屏蔽错误显示，最终被错误地渲染了红色边框。

另外，也有可能是SourceIconColorButton的自定义实现中，内部绑定没有关闭验证（比如绑定到Icon属性，而Icon本身带有[Required]特性），但根据你描述的“Name错误时无关控件也红”的场景，前者的概率更高。

解决思路 #

方案1：关闭ListBoxItem的Content绑定验证 #

在ListBoxItem的样式中，显式设置Content绑定并关闭验证，切断对象级错误向ListBoxItem的传递：

<Style x:Key="SourceListBoxItem" TargetType="ListBoxItem">
    <!-- 添加这一行，关闭Content绑定的对象级验证 -->
    <Setter Property="Content" Value="{Binding ValidatesOnNotifyDataErrors=False}" />
    <Setter Property="Template">
        <!-- 原有模板内容不变 -->
    </Setter>
</Style>

方案2：为SourceIconColorButton设置空错误模板 #

直接屏蔽该控件的错误显示，即使有绑定错误也不渲染边框：

<userControls:SourceIconColorButton 
    BackgroundColor="{Binding DataContext.Color, RelativeSource={RelativeSource AncestorType=ListBoxItem }}"
    IconName="{Binding DataContext.Icon, RelativeSource={RelativeSource AncestorType=ListBoxItem}}"
    DataContext="{Binding DataContext, RelativeSource={RelativeSource AncestorType= ListBoxItem}}"
    Command="{Binding DataContext.ShowColorIconDialogCommand, RelativeSource={RelativeSource AncestorType=UserControl}}">
    <!-- 空模板，不显示错误边框 -->
    <Validation.ErrorTemplate>
        <ControlTemplate/>
    </Validation.ErrorTemplate>
</userControls:SourceIconColorButton>

也可以把这个设置放到该控件的默认样式中，避免重复编写。

方案3：禁用SourceIconColorButton的验证功能 #

如果该控件不需要任何验证逻辑，可以直接关闭其验证开关：

<userControls:SourceIconColorButton 
    ...
    Validation.IsEnabled="False"/>

WPF验证机制核心原理 #

WPF的验证是绑定驱动的，核心逻辑如下：

1. 绑定级错误检测：每个绑定（比如TextBox的Text绑定）会根据配置（ValidatesOnNotifyDataErrors、ValidatesOnDataErrors等）检测属性或对象的错误。
2. INotifyDataErrorInfo接口：ObservableValidator实现了这个接口，当属性验证失败时，会触发ErrorsChanged事件，UI通过监听该事件更新验证状态。
3. Validation附加属性：每个控件的Validation.HasError属性记录自身所有绑定的错误状态；Validation.Errors集合存储具体错误信息。
4. 错误模板：默认情况下，控件会使用系统自带的错误模板（红色边框），当Validation.HasError为True时自动显示。
5. 对象级验证传递：如果绑定的目标是整个DataContext（如ListBoxItem的默认Content绑定），且ValidatesOnNotifyDataErrors=True，则只要DataContext的HasErrors为True，该绑定就会触发错误，导致控件的Validation.HasError为True。

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