WPF如何通过数据绑定为FlowDocument生成多个Paragraph元素

问题原因 #

你的代码无法正常生效的核心原因是WPF流文档模型的限制：FlowDocument的子元素只能是继承自Block基类的文档块（比如Paragraph、Section、List、Table等），而ItemsControl属于普通UI框架元素，不属于Block类型，直接放在FlowDocument节点下不会被文档模型识别渲染，且原生FlowDocument没有提供集合绑定自动生成Block元素的能力。

正确实现方案 #

通过自定义附加属性扩展FlowDocument的绑定能力，监听绑定集合的变化自动生成对应的Paragraph元素，不需要后台手动编写文档元素操作代码。

第一步：编写流文档绑定辅助类

using System.Collections;
using System.Collections.Specialized;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;

public static class FlowDocumentBindHelper
{
    public static readonly DependencyProperty ItemsSourceProperty = DependencyProperty.RegisterAttached(
        "ItemsSource", typeof(IEnumerable), typeof(FlowDocumentBindHelper),
        new PropertyMetadata(null, OnItemsSourceChanged));

    public static void SetItemsSource(DependencyObject obj, IEnumerable value) => obj.SetValue(ItemsSourceProperty, value);
    public static IEnumerable GetItemsSource(DependencyObject obj) => (IEnumerable)obj.GetValue(ItemsSourceProperty);

    public static readonly DependencyProperty ItemTemplateProperty = DependencyProperty.RegisterAttached(
        "ItemTemplate", typeof(DataTemplate), typeof(FlowDocumentBindHelper), new PropertyMetadata(null));

    public static void SetItemTemplate(DependencyObject obj, DataTemplate value) => obj.SetValue(ItemTemplateProperty, value);
    public static DataTemplate GetItemTemplate(DependencyObject obj) => (DataTemplate)obj.GetValue(ItemTemplateProperty);

    private static void OnItemsSourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not FlowDocument doc) return;
        doc.Blocks.Clear();

        if (e.NewValue is not IEnumerable items) return;
        var template = GetItemTemplate(doc);

        // 初始化渲染现有项
        foreach (var item in items)
        {
            doc.Blocks.Add(GenerateParagraph(item, template));
        }

        // 监听动态集合变更，自动刷新内容
        if (e.NewValue is INotifyCollectionChanged notifyColl)
        {
            notifyColl.CollectionChanged += (s, args) =>
            {
                doc.Blocks.Clear();
                foreach (var currItem in s as IEnumerable)
                {
                    doc.Blocks.Add(GenerateParagraph(currItem, template));
                }
            };
        }
    }

    private static Paragraph GenerateParagraph(object dataItem, DataTemplate template)
    {
        var host = new ContentControl
        {
            Content = dataItem,
            ContentTemplate = template
        };
        var inlineContainer = new InlineUIContainer(host);
        return new Paragraph(inlineContainer);
    }
}

第二步：XAML中使用绑定

把辅助类的命名空间引入XAML后，直接给FlowDocument设置绑定属性即可，不需要内嵌ItemsControl：

<!-- 先引入辅助类所在的本地代码命名空间 -->
<Window xmlns:local="clr-namespace:YourProjectNamespace">
    <RichTextBox>
        <FlowDocument 
            local:FlowDocumentBindHelper.ItemsSource="{Binding Lines}"
            local:FlowDocumentBindHelper.ItemTemplate="{StaticResource LineEditTemplate}">
            <FlowDocument.Resources>
                <DataTemplate x:Key="LineEditTemplate">
                    <!-- 编辑场景用TextBox，只读场景可以直接换成<Run Text="{Binding Text}"/> -->
                    <TextBox Text="{Binding Text, UpdateSourceTrigger=PropertyChanged}"
                             BorderThickness="0"
                             Padding="2 0"/>
                </DataTemplate>
            </FlowDocument.Resources>
        </FlowDocument>
    </RichTextBox>
</Window>

补充说明 #

• 上面的实现支持ObservableCollection<T>类型的动态绑定，集合增删时会自动刷新文档内容，如果有更高性能要求，可以把集合变更逻辑改成增量更新，不需要每次全量重绘。
• 如果是纯文本只读展示场景，可以修改辅助类逻辑，直接生成带Run的Paragraph，不需要嵌套UI容器，渲染性能会更高。
• 如果不需要FlowDocument特有的富文本排版、打印、流布局能力，直接用普通ItemsControl绑定集合，重写ItemTemplate嵌套TextBox/TextBlock实现成本更低。

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