PDFtron加载PDF时抛出Value does not fall within the expected range异常

你遇到的{"Value does not fall within the expected range."}异常在WPF PDF加载场景下，主要有以下几类触发原因：

• UI视觉树冲突：这是最高概率的触发原因。WPF规定同一个UI元素实例只能属于唯一的父视觉节点。你当前的代码存在两处冲突：
  1. XAML中PDFViewCtrlBorder内部的Border已经绑定了Child="{Binding}"，C#代码中又手动给PDFViewCtrlBorder.Child赋值PDFViewCtrl，相当于要将同一个控件挂载到两个父容器
  2. 加载第二份PDF时，PDFViewCtrl还挂载在前一份文档的父容器上，直接赋值新父容器就会触发参数范围异常
• PDF文档本身异常：第二份PDF存在格式损坏、版本低于当前控件支持的最低版本、有加密/编辑权限限制未处理
• 传入参数异常：加载第二份文档时传入的pdfDoc对象为null，或内部的页码、文档尺寸等属性超出控件支持的阈值
• 资源未正确释放：加载第二份文档前，没有释放PDFViewCtrl中前一份文档的占用资源，导致新文档的属性和旧属性冲突

• 打断点定位异常抛出的具体代码行：
  • 若异常在PDFViewCtrlBorder.Child = ...行抛出，可直接确认是UI视觉树冲突问题
  • 若异常在OpenDoc(pdfDoc)行抛出，优先排查文档本身或传入参数问题
• 用常规PDF阅读器打开第二份文档，确认文档无损坏、无加密、可正常读取
• 打印pdfDoc的核心属性，确认实例不为null，文档页数、宽高参数正常
• 赋值PDFViewCtrlBorder.Child前，打印vm.PDFViewCtrl.Parent的值，确认是否已经存在父容器

1. 修复UI视觉树冲突 #

首先删除XAML中多余的Child绑定，避免重复挂载：

<Grid
x:Name="PaperGrid"
Grid.Row="0"
Grid.RowSpan="2"
Background="{StaticResource WhiteBackgroundBrush}"
Visibility="Collapsed">
    <Border x:Name="PDFViewCtrlBorder" >
        <Grid>
            <!-- 移除原有 <Border Child="{Binding}" /> 代码行 -->
        </Grid>
    </Border>
</Grid>

修改C#代码，赋值前先清理控件的旧父级挂载：

var vm = this.DataContext as ViewerPageViewModel;
// 加载新文档前先清理旧资源
if (vm.PDFViewCtrl != null && vm.PDFViewCtrl.Document != null)
{
    vm.PDFViewCtrl.CloseDoc();
    vm.PDFViewCtrl.Document.Dispose();
}
// 清理旧父容器挂载
if (vm.PDFViewCtrl.Parent is FrameworkElement oldParent)
{
    if (oldParent is Panel panel)
    {
        panel.Children.Remove(vm.PDFViewCtrl);
    }
    else if (oldParent is Border border)
    {
        border.Child = null;
    }
}
vm.Activate();
vm.OpenDoc(pdfDoc);
PDFViewCtrlBorder.Child = vm.PDFViewCtrl;

2. 修复文档相关异常 #

• 若文档加密，调用OpenDoc时传入对应的解密密码参数
• 若文档版本不兼容，升级PDF阅读器控件版本，或将文档转码为控件支持的兼容版本

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