.NET7 WPF DataGrid清空行后调整列宽触发Visual异常问题

问题原因 #

这些异常的核心根源是动态切换ScrollViewer可见性时，DataGrid内部可视化树的父子关系被破坏：

• 当ScrollViewer被设为Hidden/Collapsed，或数据清空触发可见性绑定更新时，DataGrid的核心视觉元素（列头容器、行容器）会意外脱离可视化树；后续操作（调整列宽、排序、滚动）尝试访问这些已脱离的元素时，就会抛出The specified Visual is not an ancestor of this Visual异常。
• 数据清空后立即执行滚动、排序操作，会导致DataGrid的布局更新与视觉元素回收不同步，内部逻辑访问了已被移除的Visual节点，直接引发崩溃。

解决办法 #

1. 避免直接绑定ScrollViewer的Visibility #

不要把ScrollViewer的可见性直接绑定到数据行状态，改为控制内部ItemsPresenter的可见性，保留ScrollViewer在可视化树中的存在：

<!-- 错误写法 -->
<ScrollViewer Visibility="{Binding HasAtLeastOneRow, Converter={StaticResource BoolToVis}}">
    <!-- ... -->
</ScrollViewer>

<!-- 修改后 -->
<ScrollViewer>
    <ItemsPresenter Visibility="{Binding HasAtLeastOneRow, Converter={StaticResource BoolToVis}}"/>
</ScrollViewer>

2. 数据清空后强制同步布局状态 #

在清空数据行并更新HasAtLeastOneRow后，手动触发DataGrid的布局和视觉状态更新，确保可视化树同步：

public void ClearDataRows()
{
    YourDataView.Clear();
    HasAtLeastOneRow = false;
    
    // 强制更新布局，避免视觉元素状态不一致
    TargetDataGrid.UpdateLayout();
    TargetDataGrid.InvalidateVisual();
}

3. 调整自定义ControlTemplate结构，保留默认视觉依赖 #

自定义模板时不要完全破坏DataGrid的默认可视化树结构，确保DataGridColumnHeadersPresenter始终作为ScrollViewer的内部元素存在，参考默认模板结构：

<ControlTemplate TargetType="{x:Type DataGrid}">
    <Border Background="{TemplateBinding Background}"
            BorderBrush="{TemplateBinding BorderBrush}"
            BorderThickness="{TemplateBinding BorderThickness}"
            SnapsToDevicePixels="True">
        <ScrollViewer x:Name="DG_ScrollViewer" Focusable="false">
            <ScrollViewer.Template>
                <ControlTemplate TargetType="{x:Type ScrollViewer}">
                    <Grid>
                        <Grid.RowDefinitions>
                            <RowDefinition Height="Auto"/>
                            <RowDefinition Height="*"/>
                            <RowDefinition Height="Auto"/>
                        </Grid.RowDefinitions>
                        <Grid.ColumnDefinitions>
                            <ColumnDefinition Width="Auto"/>
                            <ColumnDefinition Width="*"/>
                            <ColumnDefinition Width="Auto"/>
                        </Grid.ColumnDefinitions>
                        <!-- 列头容器保留在ScrollViewer内部 -->
                        <DataGridColumnHeadersPresenter x:Name="PART_ColumnHeadersPresenter"
                                                        Grid.Row="0" Grid.Column="1"
                                                        Visibility="{TemplateBinding HeadersVisibility, Converter={x:Static DataGrid.HeadersVisibilityConverter}}"/>
                        <ScrollContentPresenter x:Name="PART_ScrollContentPresenter"
                                                Grid.Row="1" Grid.Column="1"
                                                CanContentScroll="{TemplateBinding CanContentScroll}"/>
                        <ScrollBar x:Name="PART_VerticalScrollBar"
                                   Grid.Row="1" Grid.Column="2"
                                   Value="{Binding VerticalOffset, Mode=OneWay, RelativeSource={RelativeSource TemplatedParent}}"
                                   Maximum="{Binding ScrollableHeight, Mode=OneWay, RelativeSource={RelativeSource TemplatedParent}}"
                                   ViewportSize="{Binding ViewportHeight, Mode=OneWay, RelativeSource={RelativeSource TemplatedParent}}"
                                   Visibility="{TemplateBinding ComputedVerticalScrollBarVisibility}"/>
                        <ScrollBar x:Name="PART_HorizontalScrollBar"
                                   Grid.Row="2" Grid.Column="1"
                                   Value="{Binding HorizontalOffset, Mode=OneWay, RelativeSource={RelativeSource TemplatedParent}}"
                                   Maximum="{Binding ScrollableWidth, Mode=OneWay, RelativeSource={RelativeSource TemplatedParent}}"
                                   ViewportSize="{Binding ViewportWidth, Mode=OneWay, RelativeSource={RelativeSource TemplatedParent}}"
                                   Visibility="{TemplateBinding ComputedHorizontalScrollBarVisibility}"/>
                    </Grid>
                </ControlTemplate>
            </ScrollViewer.Template>
            <ItemsPresenter SnapsToDevicePixels="{TemplateBinding SnapsToDevicePixels}"/>
        </ScrollViewer>
    </Border>
</ControlTemplate>

4. 规避.NET7已知bug #

该问题属于.NET7 WPF的已知缺陷（对应GitHub Issue #8640），如果上述方案无效，可临时降级到.NET6，或等待官方修复补丁。同时避免在可见性切换后立即执行列宽调整、排序等操作，给布局更新预留时间。

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