WPF中ItemsControl绑定UserControl集合未显示ItemTemplate问题

问题根源 #

你遇到的核心问题是：ItemsControl的ItemsSource绑定的是BaseView（UserControl子类）的实例集合，而WPF内置了针对UIElement类型数据的处理逻辑——当数据项本身就是可视化元素时，ItemsControl会直接渲染这个元素，完全跳过你定义的ItemTemplate。这是WPF为了方便直接展示UI元素而设计的默认行为。

解决方案 #

方案1：改用ViewModel作为集合项（推荐，符合MVVM架构）

这是类MDI界面的标准实现方式，步骤如下：

1. 创建BaseViewModel基类，继承INotifyPropertyChanged，封装视图需要的属性（比如标题Title、是否激活IsActive等）
2. 将你的ObservableCollection类型改为ObservableCollection<BaseViewModel>，后续打开新视图时，实例化对应的ViewModel并添加到集合中
3. 在ItemsControl中定义DataTemplate，绑定ViewModel的属性来显示自定义的标题栏样式：

   <ItemsControl ItemsSource="{Binding OpenViewModels}">
       <ItemsControl.ItemTemplate>
           <DataTemplate>
               <Border BorderThickness="1" BorderBrush="LightGray" Padding="4" Margin="2"
                       Background="{Binding IsActive, Converter={StaticResource BoolToBrushConverter}}">
                   <TextBlock Text="{Binding Title}" />
               </Border>
           </DataTemplate>
       </ItemsControl.ItemTemplate>
   </ItemsControl>
   

4. 主窗口的ContentControl通过隐式DataTemplate匹配ViewModel和View：

   <Window.Resources>
       <DataTemplate DataType="{x:Type local:TestViewModel}">
           <local:TestView />
       </DataTemplate>
   </Window.Resources>
   <ContentControl Content="{Binding SelectedViewModel}" />
   

这种方式不仅解决了ItemsControl的显示问题，还能让你更方便地管理视图状态、实现视图切换和生命周期控制。

方案2：强制ItemsControl应用ItemTemplate（不推荐，仅临时应急）

如果暂时不想重构为MVVM模式，可以通过修改ItemContainerStyle强制覆盖默认行为：

<ItemsControl ItemsSource="{Binding OpenViews}">
    <ItemsControl.ItemContainerStyle>
        <Style TargetType="ContentPresenter">
            <!-- 强制应用自定义模板，忽略原UIElement实例 -->
            <Setter Property="ContentTemplate" Value="{StaticResource ViewItemTemplate}" />
            <!-- 将原View实例作为模板的数据上下文，以便绑定属性 -->
            <Setter Property="DataContext" Value="{Binding}" />
        </Style>
    </ItemsControl.ItemContainerStyle>
    <ItemsControl.Resources>
        <DataTemplate x:Key="ViewItemTemplate">
            <Border BorderThickness="1" BorderBrush="Gray" Padding="5">
                <TextBlock Text="{Binding Title}" />
            </Border>
        </DataTemplate>
    </ItemsControl.Resources>
</ItemsControl>

注意：这种方式会绕过WPF的默认UI元素处理逻辑，不符合数据驱动的设计思想，后期维护难度大，不建议在正式项目中使用。

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