在C# WPF項目中集成PDF查看器的兩種方法

更新時間：2025年12月29日 09:40:09 作者：????風、凌???

文章介紹了在WPF中使用PdfiumViewer控件的兩種方法：通過NuGet包安裝并手動創(chuàng)建控件,創(chuàng)建自定義WPF控件,文章還解決了在WPF中使用PdfiumViewer時可能出現(xiàn)的常見問題,需要的朋友可以參考下

方法1：通過 NuGet 包安裝并手動創(chuàng)建控件（推薦）

1. 安裝 NuGet 包

<!-- 在你的 WPF 項目的 .csproj 文件中添加 -->
<PackageReference Include="PdfiumViewer" Version="2.11.0" />
<PackageReference Include="PdfiumViewer.Native.x86_64.v8-xfa" Version="2023.6.12.1" />

或通過 NuGet 包管理器控制臺：

Install-Package PdfiumViewer
Install-Package PdfiumViewer.Native.x86_64.v8-xfa

2. 在 XAML 中設置 WindowsFormsHost

由于 PdfiumViewer 是 WinForms 控件，需要在 WPF 中使用 WindowsFormsHost：

<!-- 在 MainWindow.xaml 中 -->
<Window x:Class="YourNamespace.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:wf="clr-namespace:System.Windows.Forms;assembly=System.Windows.Forms"
        mc:Ignorable="d"
        Title="PDF Viewer" Height="600" Width="800">
    
    <Grid>
        <WindowsFormsHost x:Name="pdfHost" Margin="10"/>
    </Grid>
</Window>

3. 在代碼后臺創(chuàng)建和使用 PdfViewer

using System;
using System.Windows;
using PdfiumViewer;
using System.Windows.Forms.Integration;

namespace YourNamespace
{
    public partial class MainWindow : Window
    {
        private PdfViewer pdfViewer;
        
        public MainWindow()
        {
            InitializeComponent();
            InitializePdfViewer();
        }
        
        private void InitializePdfViewer()
        {
            // 創(chuàng)建 PdfViewer 實例
            pdfViewer = new PdfViewer();
            pdfViewer.Dock = System.Windows.Forms.DockStyle.Fill;
            
            // 將 PdfViewer 添加到 WindowsFormsHost
            pdfHost.Child = pdfViewer;
        }
        
        // 打開 PDF 文件
        private void OpenPdf(string filePath)
        {
            try
            {
                // 加載 PDF 文檔
                pdfViewer.Document = PdfDocument.Load(filePath);
            }
            catch (Exception ex)
            {
                MessageBox.Show($"打開 PDF 失敗: {ex.Message}");
            }
        }
        
        // 示例：在窗口加載時打開 PDF
        private void Window_Loaded(object sender, RoutedEventArgs e)
        {
            OpenPdf(@"C:\path\to\your\document.pdf");
        }
    }
}

方法2：創(chuàng)建自定義 WPF 控件（更優(yōu)雅）

1. 創(chuàng)建 PdfViewerWrapper 用戶控件

<!-- PdfViewerWrapper.xaml -->
<UserControl x:Class="YourNamespace.Controls.PdfViewerWrapper"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             mc:Ignorable="d" 
             d:DesignHeight="450" d:DesignWidth="800">
    <Grid>
        <WindowsFormsHost x:Name="host"/>
    </Grid>
</UserControl>

// PdfViewerWrapper.xaml.cs
using System;
using System.Windows;
using System.Windows.Controls;
using PdfiumViewer;
using System.Windows.Forms.Integration;

namespace YourNamespace.Controls
{
    public partial class PdfViewerWrapper : UserControl
    {
        private PdfViewer pdfViewer;
        
        public PdfViewerWrapper()
        {
            InitializeComponent();
            InitializePdfViewer();
        }
        
        private void InitializePdfViewer()
        {
            pdfViewer = new PdfViewer
            {
                Dock = System.Windows.Forms.DockStyle.Fill
            };
            host.Child = pdfViewer;
        }
        
        // 打開 PDF 文件
        public void LoadPdf(string filePath)
        {
            try
            {
                pdfViewer.Document = PdfDocument.Load(filePath);
            }
            catch (Exception ex)
            {
                MessageBox.Show($"加載 PDF 失敗: {ex.Message}");
            }
        }
        
        // 從字節(jié)數(shù)組加載
        public void LoadPdf(byte[] pdfData)
        {
            try
            {
                pdfViewer.Document = PdfDocument.Load(pdfData);
            }
            catch (Exception ex)
            {
                MessageBox.Show($"加載 PDF 失敗: {ex.Message}");
            }
        }
        
        // 從流加載
        public void LoadPdf(System.IO.Stream stream)
        {
            try
            {
                pdfViewer.Document = PdfDocument.Load(stream);
            }
            catch (Exception ex)
            {
                MessageBox.Show($"加載 PDF 失敗: {ex.Message}");
            }
        }
        
        // 獲取當前頁面索引
        public int GetCurrentPage()
        {
            return pdfViewer?.Renderer?.Page ?? 0;
        }
        
        // 跳轉(zhuǎn)到指定頁面
        public void GoToPage(int page)
        {
            if (pdfViewer?.Renderer != null && page >= 0 && page < pdfViewer.Document.PageCount)
            {
                pdfViewer.Renderer.Page = page;
            }
        }
    }
}

2. 在主窗口中使用自定義控件

<!-- MainWindow.xaml -->
<Window x:Class="YourNamespace.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:controls="clr-namespace:YourNamespace.Controls"
        Title="PDF Viewer" Height="600" Width="800">
    
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        
        <!-- 工具欄 -->
        <StackPanel Grid.Row="0" Orientation="Horizontal" Margin="10">
            <Button Content="打開 PDF" Click="OpenPdfButton_Click" Margin="5"/>
            <Button Content="上一頁" Click="PrevPageButton_Click" Margin="5"/>
            <Button Content="下一頁" Click="NextPageButton_Click" Margin="5"/>
            <TextBlock Text="頁碼：" VerticalAlignment="Center" Margin="10,0,5,0"/>
            <TextBlock x:Name="pageInfo" VerticalAlignment="Center"/>
        </StackPanel>
        
        <!-- PDF 查看器 -->
        <controls:PdfViewerWrapper x:Name="pdfViewerControl" Grid.Row="1"/>
    </Grid>
</Window>

// MainWindow.xaml.cs
using Microsoft.Win32;
using System.Windows;

namespace YourNamespace
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
        
        private void OpenPdfButton_Click(object sender, RoutedEventArgs e)
        {
            var openFileDialog = new OpenFileDialog
            {
                Filter = "PDF 文件|*.pdf|所有文件|*.*",
                Title = "選擇 PDF 文件"
            };
            
            if (openFileDialog.ShowDialog() == true)
            {
                pdfViewerControl.LoadPdf(openFileDialog.FileName);
            }
        }
        
        private void PrevPageButton_Click(object sender, RoutedEventArgs e)
        {
            int currentPage = pdfViewerControl.GetCurrentPage();
            if (currentPage > 0)
            {
                pdfViewerControl.GoToPage(currentPage - 1);
            }
        }
        
        private void NextPageButton_Click(object sender, RoutedEventArgs e)
        {
            int currentPage = pdfViewerControl.GetCurrentPage();
            pdfViewerControl.GoToPage(currentPage + 1);
        }
    }
}

方法3：使用 PdfRenderer 而不是 PdfViewer

如果你只需要簡單的 PDF 渲染（沒有工具欄），可以使用 PdfRenderer：

using System.Windows;
using System.Windows.Forms.Integration;
using PdfiumViewer;

public partial class MainWindow : Window
{
    private PdfRenderer pdfRenderer;
    
    public MainWindow()
    {
        InitializeComponent();
        InitializePdfRenderer();
    }
    
    private void InitializePdfRenderer()
    {
        pdfRenderer = new PdfRenderer();
        pdfRenderer.Dock = System.Windows.Forms.DockStyle.Fill;
        pdfRenderer.ZoomMode = PdfViewerZoomMode.FitWidth;
        
        // 添加到 WindowsFormsHost
        var host = new WindowsFormsHost();
        host.Child = pdfRenderer;
        
        // 添加到 WPF 容器
        contentContainer.Children.Add(host);
    }
    
    private void LoadPdf(string filePath)
    {
        var document = PdfDocument.Load(filePath);
        pdfRenderer.Load(document);
    }
}

解決常見問題

問題1：找不到 PdfiumViewer 控件

原因：PdfiumViewer 是 WinForms 控件，不會自動出現(xiàn)在 WPF 工具箱中
解決方案：手動創(chuàng)建控件實例，如上所示

問題2：運行時異常（DLL 未找到）

<!-- 在 .csproj 中確保包含 Native 包 -->
<PackageReference Include="PdfiumViewer.Native.x86_64.v8-xfa" Version="2023.6.12.1" />
<!-- 或 x86 版本 -->
<PackageReference Include="PdfiumViewer.Native.x86.v8-xfa" Version="2023.6.12.1" />

問題3：設計時看不到控件

原因：WinForms 控件在 WPF 設計器中不可見
解決方案：在設計時顯示占位符，運行時加載真實控件

<!-- 在設計時顯示標簽，運行時替換 -->
<UserControl>
    <Grid>
        <TextBlock x:Name="designText" 
                   Text="PDF Viewer (設計時)"
                   Visibility="{Binding IsInDesignMode, Converter={StaticResource BoolToVisibilityConverter}}"/>
        <WindowsFormsHost x:Name="host" 
                          Visibility="{Binding IsInDesignMode, Converter={StaticResource BoolToVisibilityInverseConverter}}"/>
    </Grid>
</UserControl>

完整示例項目結構

YourSolution/
├── YourWpfProject/
│   ├── Controls/
│   │   ├── PdfViewerWrapper.xaml
│   │   └── PdfViewerWrapper.xaml.cs
│   ├── MainWindow.xaml
│   ├── MainWindow.xaml.cs
│   └── YourWpfProject.csproj
└── YourWpfProject.sln

在工具箱中手動添加控件（可選）

雖然不能直接拖拽，但你可以：

創(chuàng)建自定義控件庫：將 PdfViewerWrapper 控件編譯為獨立的 DLL
添加到工具箱：
- 右鍵點擊工具箱 → “選擇項”
- 瀏覽并選擇你的控件 DLL
- 控件將出現(xiàn)在工具箱中

總結

在 WPF 中使用 PdfiumViewer 的關鍵步驟：

安裝 NuGet 包：PdfiumViewer 及其 Native 包
使用 WindowsFormsHost：承載 WinForms 控件
代碼創(chuàng)建控件：在代碼后臺或自定義用戶控件中實例化 PdfViewer
加載 PDF：使用 PdfDocument.Load() 方法

雖然不能像 WinForms 那樣直接在工具箱中拖拽，但通過創(chuàng)建自定義用戶控件，你可以在 WPF 中獲得類似的開發(fā)體驗。

以上就是在C# WPF項目中集成PDF查看器的兩種方法的詳細內(nèi)容，更多關于C# WPF集成PDF查看器的資料請關注腳本之家其它相關文章！

您可能感興趣的文章:

Log4Net 日志配置[附帶源碼下載]
這篇文章主要介紹了Log4Net 日志配置[附帶源碼下載],需要的朋友可以參考下
2015-05-05
兩路歸并的數(shù)組與鏈表的實現(xiàn)方法
本篇文章對兩路歸并的數(shù)組與鏈表的實現(xiàn)方法進行了分析介紹。需要的朋友參考下
2013-05-05
WPF實現(xiàn)虛擬鍵盤代替真實鍵盤的全過程
在工業(yè)控制、自助終端、醫(yī)療設備等場景中,物理鍵盤往往存在易損壞、體積過大、操作環(huán)境受限等問題,而WPF憑借其強大的界面定制能力、數(shù)據(jù)綁定特性和可視化渲染效果,能夠完美實現(xiàn)一款可替代真實鍵盤的虛擬鍵盤,本文將詳細講解WPF虛擬鍵盤的完整實現(xiàn)流程
2026-01-01
C#中城市線路圖的純算法以及附帶求極權值
本篇文章介紹了，在C#中城市線路圖的純算法以及附帶求極權值的方法，需要的朋友參考下
2013-04-04
C# 刪除字符串中的中文（實例分享）
本文主要分享了C#刪除字符串中的中文的具體實例，具有一定的參考價值，需要的朋友一起來看下吧
2016-12-12
C#在Excel表格中插入、編輯和刪除批注
這篇文章主要為大家詳細介紹了C#如何在Excel表格中插入、編輯和刪除批注，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2018-06-06
DevExpress實現(xiàn)GridControl刪除所有行的方法
這篇文章主要介紹了DevExpress實現(xiàn)GridControl刪除所有行的方法,對于C#初學者有一定的參考借鑒價值,需要的朋友可以參考下
2014-08-08
在winform下實現(xiàn)左右布局多窗口界面的方法之續(xù)篇
這篇文章主要介紹了在winform下實現(xiàn)左右布局多窗口界面的方法之續(xù)篇的相關資料,需要的朋友可以參考下
2016-02-02
C#使用融合通信API發(fā)送手機短信功能
融合云通信服務平臺,為企業(yè)提供全方位通信服務,發(fā)送手機短信是其一項核心功能,本文介紹了如何使用融合云通信服務平臺的API通過C#實現(xiàn)發(fā)送手機短信的功能,感興趣的朋友跟隨小編一起看看吧
2024-11-11
基于C#實現(xiàn)12306的動態(tài)驗證碼變成靜態(tài)驗證碼的方法
這篇文章主要介紹了基于C#實現(xiàn)12306的動態(tài)驗證碼變成靜態(tài)驗證碼的方法的相關資料,需要的朋友可以參考下
2015-12-12