You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Blazor Bootstrap PDF Viewer示例代码无法加载文档问题求助

Blazor Bootstrap PDF Viewer 文档不显示/OnDocumentLoaded未触发排查方案
  • 确认依赖安装与资源引用
    确保已通过NuGet安装对应版本的Blazor.Bootstrap包,同时在项目的入口文件中正确引入静态资源:

    • Server项目:_Host.cshtml中添加
      <link href="_content/Blazor.Bootstrap/blazor.bootstrap.css" rel="stylesheet" />
      <script src="_content/Blazor.Bootstrap/blazor.bootstrap.js"></script>
      
    • WASM项目:index.html中添加上述引用
  • 检查PDF文件加载逻辑

    • 本地文件需设置复制到输出目录(右键文件→属性→复制到输出目录:如果较新则复制),避免路径找不到文件
    • 优先通过HttpClient加载wwwroot下的静态文件,避免相对路径解析错误,示例:
      private async Task LoadPdfAsync()
      {
          var stream = await HttpClient.GetStreamAsync("docs/sample.pdf"); // sample.pdf放在wwwroot/docs下
          await PdfViewer.LoadAsync(stream);
      }
      
  • 规范组件初始化与事件绑定
    确保组件引用获取正确,且在组件完成DOM渲染后再加载PDF,避免在OnInitializedAsync中调用加载方法:

    <BlazorBootstrap.PdfViewer @ref="pdfViewer" OnDocumentLoaded="HandleDocumentLoaded" />
    
    @code {
        private BlazorBootstrap.PdfViewer pdfViewer;
    
        private void HandleDocumentLoaded(DocumentLoadedEventArgs args)
        {
            // 事件处理逻辑
        }
    
        protected override async Task OnAfterRenderAsync(bool firstRender)
        {
            if (firstRender)
            {
                await LoadPdfAsync();
            }
            await base.OnAfterRenderAsync(firstRender);
        }
    }
    
  • 排查浏览器控制台错误
    打开浏览器F12开发者工具,查看Console标签页是否有PDF.js相关的加载失败提示(Blazor Bootstrap PDF Viewer依赖PDF.js),若存在资源缺失问题,需确认包依赖是否完整,必要时手动补充PDF.js的引用。

  • 验证版本兼容性
    确认Blazor Bootstrap版本与你的.NET版本匹配,比如.NET 6/7/8对应不同的组件版本,版本不匹配可能导致初始化失败。


内容的提问来源于stack exchange,提问作者Pierre Pirnay

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.19 04:42:04