在Windows窗体PictureBox中渲染PDF页面 | C#指南

如何在 Windows Forms 项目中安装 IronPDF？

在编写任何代码之前，您需要将 IronPDF 添加到您的项目中。 最快的方法是通过 NuGet 包管理器 CLI：

dotnet add package IronPdf

dotnet add package IronPdf

或者，使用 Visual Studio 包管理器控制台：

Install-Package IronPdf

Install-Package IronPdf

安装完成后，请确认包引用出现在您的 .csproj 文件中。IronPDF 的目标平台是 Windows，运行在 .NET 6 及更高版本上。因此，如果您在项目文件中使用跨平台目标，请为 Windows 添加 <RuntimeIdentifiers> 或 <Platforms> 限制。 对于 Windows Forms 项目，在 Visual Studio 中创建项目模板时，通常已经配置好了。

对于生产环境中的许可，请将您的许可证密钥放在应用程序启动代码中，且位于所有 IronPDF 调用之前：

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

在开发和评估过程中，IronPDF 以试用模式运行，这会在渲染输出中添加水印。 免费试用许可证会移除水印，用于测试目的。

如何设置 Windows Forms 项目结构？

打开 Visual Studio 并创建一个面向 .NET 10 的新 Windows 窗体应用程序项目。项目模板生成一个 Form1.cs 和一个 Program.cs 入口点。

在设计器界面中，将以下控件添加到表单中：

• 一个名为 PictureBox 的 pictureBoxPdf 覆盖了表单的大部分区域，其中 SizeMode 设置为 Zoom
• 一个名为 Button 的 btnOpen，文本为"打开 PDF"
• 一个名为 Button 的 btnPrevious，文本为"上一页"
• 一个名为 Button 的 btnNext，文本为"下一个"
• 一个名为 Button 的 btnSave，文本为"保存页面"
• 一个名为 Button 的 btnPrint，文本为"打印"
• 一个名为 Label 的 lblPageInfo，用于显示当前页码

PictureBox 上的 SizeMode = Zoom 设置可确保 PDF 页面按比例缩放以适应控件，而不会扭曲纵横比。 这一点很重要，因为 PDF 页面的大小各不相同——信纸、A4 和法律格式的尺寸都不同，您希望查看器能够优雅地处理所有这些尺寸。

以下是PDF查看器应用程序的完整表单代码。 这使用了 Program.cs 中的顶级语句，并将完整的查看器逻辑放在 Form1.cs 中：

using IronPdf;
using IronSoftware.Drawing;
using System.Drawing;

public partial class Form1 : Form
{
    private PdfDocument? currentPdf;
    private AnyBitmap[]? pageImages;
    private int currentPageIndex = 0;

    public Form1()
    {
        InitializeComponent();
        pictureBoxPdf.SizeMode = PictureBoxSizeMode.Zoom;
        UpdateNavigationState();
    }

    private void UpdateNavigationState()
    {
        bool hasPdf = pageImages != null && pageImages.Length > 0;
        btnPrevious.Enabled = hasPdf && currentPageIndex > 0;
        btnNext.Enabled = hasPdf && currentPageIndex < (pageImages?.Length - 1 ?? 0);
        btnSave.Enabled = hasPdf;
        btnPrint.Enabled = hasPdf;
        lblPageInfo.Text = hasPdf
            ? $"Page {currentPageIndex + 1} of {pageImages!.Length}"
            : "No document loaded";
    }
}

using IronPdf;
using IronSoftware.Drawing;
using System.Drawing;

public partial class Form1 : Form
{
    private PdfDocument? currentPdf;
    private AnyBitmap[]? pageImages;
    private int currentPageIndex = 0;

    public Form1()
    {
        InitializeComponent();
        pictureBoxPdf.SizeMode = PictureBoxSizeMode.Zoom;
        UpdateNavigationState();
    }

    private void UpdateNavigationState()
    {
        bool hasPdf = pageImages != null && pageImages.Length > 0;
        btnPrevious.Enabled = hasPdf && currentPageIndex > 0;
        btnNext.Enabled = hasPdf && currentPageIndex < (pageImages?.Length - 1 ?? 0);
        btnSave.Enabled = hasPdf;
        btnPrint.Enabled = hasPdf;
        lblPageInfo.Text = hasPdf
            ? $"Page {currentPageIndex + 1} of {pageImages!.Length}"
            : "No document loaded";
    }
}

Imports IronPdf
Imports IronSoftware.Drawing
Imports System.Drawing

Public Partial Class Form1
    Inherits Form

    Private currentPdf As PdfDocument
    Private pageImages As AnyBitmap()
    Private currentPageIndex As Integer = 0

    Public Sub New()
        InitializeComponent()
        pictureBoxPdf.SizeMode = PictureBoxSizeMode.Zoom
        UpdateNavigationState()
    End Sub

    Private Sub UpdateNavigationState()
        Dim hasPdf As Boolean = pageImages IsNot Nothing AndAlso pageImages.Length > 0
        btnPrevious.Enabled = hasPdf AndAlso currentPageIndex > 0
        btnNext.Enabled = hasPdf AndAlso currentPageIndex < If(pageImages?.Length - 1, 0)
        btnSave.Enabled = hasPdf
        btnPrint.Enabled = hasPdf
        lblPageInfo.Text = If(hasPdf, $"Page {currentPageIndex + 1} of {pageImages.Length}", "No document loaded")
    End Sub
End Class

UpdateNavigationState 辅助方法会根据 PDF 是否已加载以及查看器当前显示的页面来禁用或启用导航和操作按钮。 这样可以防止用户在加载文档之前点击按钮时出现空引用错误。

!a href="/static-assets/pdf/blog/vb-net-display-pdf-in-picture-box/vb-net-display-pdf-in-picture-box-1.webp">VB .NET Display PDF in PictureBox：在 Windows 窗体中将 PDF 页面渲染为图像：图片 1 - 安装 IronPDF

如何将 PDF 页面加载并渲染到 PictureBox 中？

将 PDF 加载到 PictureBox 中并渲染到 PdfDocument.FromFile 中涉及两个步骤：使用 PdfDocument.FromFile 加载文档，然后调用 ToBitmap 将所有页面转换为位图对象数组。

PDF 转图像转换方法 ToBitmap 以请求的 DPI 渲染 PDF 中的每一页。 更高的DPI可以产生更清晰的图像，但会占用更多内存。 对于文档查看器来说，150 DPI 通常是一个不错的平衡点——既能在屏幕上清晰阅读，又不会因为显示大型文档而占用大量内存。

private void btnOpen_Click(object sender, EventArgs e)
{
    using OpenFileDialog openDialog = new OpenFileDialog();
    openDialog.Filter = "PDF Files|*.pdf";
    openDialog.Title = "Select a PDF Document";

    if (openDialog.ShowDialog() == DialogResult.OK)
    {
        LoadPdfDocument(openDialog.FileName);
    }
}

private void LoadPdfDocument(string filePath)
{
    currentPdf?.Dispose();
    currentPdf = PdfDocument.FromFile(filePath);

    // Render all pages as bitmaps at 150 DPI
    pageImages = currentPdf.ToBitmap(150);
    currentPageIndex = 0;

    DisplayCurrentPage();
    UpdateNavigationState();
}

private void DisplayCurrentPage()
{
    if (pageImages == null || pageImages.Length == 0) return;

    // Convert AnyBitmap to System.Drawing.Bitmap for PictureBox
    System.Drawing.Bitmap bitmap = pageImages[currentPageIndex].ToImage<System.Drawing.Bitmap>();
    pictureBoxPdf.Image?.Dispose();
    pictureBoxPdf.Image = bitmap;

    UpdateNavigationState();
}

private void btnOpen_Click(object sender, EventArgs e)
{
    using OpenFileDialog openDialog = new OpenFileDialog();
    openDialog.Filter = "PDF Files|*.pdf";
    openDialog.Title = "Select a PDF Document";

    if (openDialog.ShowDialog() == DialogResult.OK)
    {
        LoadPdfDocument(openDialog.FileName);
    }
}

private void LoadPdfDocument(string filePath)
{
    currentPdf?.Dispose();
    currentPdf = PdfDocument.FromFile(filePath);

    // Render all pages as bitmaps at 150 DPI
    pageImages = currentPdf.ToBitmap(150);
    currentPageIndex = 0;

    DisplayCurrentPage();
    UpdateNavigationState();
}

private void DisplayCurrentPage()
{
    if (pageImages == null || pageImages.Length == 0) return;

    // Convert AnyBitmap to System.Drawing.Bitmap for PictureBox
    System.Drawing.Bitmap bitmap = pageImages[currentPageIndex].ToImage<System.Drawing.Bitmap>();
    pictureBoxPdf.Image?.Dispose();
    pictureBoxPdf.Image = bitmap;

    UpdateNavigationState();
}

Private Sub btnOpen_Click(sender As Object, e As EventArgs) Handles btnOpen.Click
    Using openDialog As New OpenFileDialog()
        openDialog.Filter = "PDF Files|*.pdf"
        openDialog.Title = "Select a PDF Document"

        If openDialog.ShowDialog() = DialogResult.OK Then
            LoadPdfDocument(openDialog.FileName)
        End If
    End Using
End Sub

Private Sub LoadPdfDocument(filePath As String)
    currentPdf?.Dispose()
    currentPdf = PdfDocument.FromFile(filePath)

    ' Render all pages as bitmaps at 150 DPI
    pageImages = currentPdf.ToBitmap(150)
    currentPageIndex = 0

    DisplayCurrentPage()
    UpdateNavigationState()
End Sub

Private Sub DisplayCurrentPage()
    If pageImages Is Nothing OrElse pageImages.Length = 0 Then Return

    ' Convert AnyBitmap to System.Drawing.Bitmap for PictureBox
    Dim bitmap As System.Drawing.Bitmap = pageImages(currentPageIndex).ToImage(Of System.Drawing.Bitmap)()
    pictureBoxPdf.Image?.Dispose()
    pictureBoxPdf.Image = bitmap

    UpdateNavigationState()
End Sub

PdfDocument.FromFile 方法将 PDF 从磁盘加载到内存中。 调用 ToBitmap 并带有 DPI 参数，返回一个 AnyBitmap 对象数组，每个页面一个对象。 AnyBitmap 类型是 IronPDF 的与格式无关的位图类，而 ToImage<System.Drawing.Bitmap>() 将其转换为 PictureBox.Image 所期望的 System.Drawing.Bitmap 类型。

请注意，在分配新对象之前，之前的 PictureBox.Image 已被释放。 这很重要——每个 Bitmap 对象都包含未托管的 GDI+ 资源，未能释放旧位图会导致长时间运行的应用程序出现内存泄漏。

!a href="/static-assets/pdf/blog/vb-net-display-pdf-in-picture-box/vb-net-display-pdf-in-picture-box-2.webp">VB .NET Display PDF in PictureBox：在 Windows 窗体中将 PDF 页面渲染为图像：图片 2 - 准备使用的空白 Windows 表单示例。

加载完成后，查看器立即显示第一页。 lblPageInfo 标签更新，显示当前页码和总页数。

!a href="/static-assets/pdf/blog/vb-net-display-pdf-in-picture-box/vb-net-display-pdf-in-picture-box-3.webp">VB .NET Display PDF in PictureBox：在 Windows 窗体中将 PDF 页面渲染为图像：图片 3 - 在我们的查看器中显示 PDF 的输入示例。

如何在PDF页面之间添加页面导航？

只能显示第一页的 PDF 查看器对于多页文档来说并不实用。 导航按钮允许用户在已渲染的页面数组中向前和向后移动：

private void btnPrevious_Click(object sender, EventArgs e)
{
    if (currentPageIndex > 0)
    {
        currentPageIndex--;
        DisplayCurrentPage();
    }
}

private void btnNext_Click(object sender, EventArgs e)
{
    if (pageImages != null && currentPageIndex < pageImages.Length - 1)
    {
        currentPageIndex++;
        DisplayCurrentPage();
    }
}

private void btnPrevious_Click(object sender, EventArgs e)
{
    if (currentPageIndex > 0)
    {
        currentPageIndex--;
        DisplayCurrentPage();
    }
}

private void btnNext_Click(object sender, EventArgs e)
{
    if (pageImages != null && currentPageIndex < pageImages.Length - 1)
    {
        currentPageIndex++;
        DisplayCurrentPage();
    }
}

Private Sub btnPrevious_Click(sender As Object, e As EventArgs)
    If currentPageIndex > 0 Then
        currentPageIndex -= 1
        DisplayCurrentPage()
    End If
End Sub

Private Sub btnNext_Click(sender As Object, e As EventArgs)
    If pageImages IsNot Nothing AndAlso currentPageIndex < pageImages.Length - 1 Then
        currentPageIndex += 1
        DisplayCurrentPage()
    End If
End Sub

每次点击事件处理程序都会将 currentPageIndex 的值加一，并调用 DisplayCurrentPage，后者会将 PictureBox.Image 的值替换为对应的位图。边界检查（currentPageIndex > 0 和 currentPageIndex < pageImages.Length - 1）可以防止索引越界异常，但 UpdateNavigationState 也会在按钮超出范围时禁用它们。

对于较大的文档，您还可以考虑添加页码输入字段，用户可以在其中输入特定的页码以直接跳转到该页，或者在侧边添加可滚动的缩略图条。pageImages 数组已经包含所有已渲染的页面，因此跳转到任意页面只需将 currentPageIndex 设置为目标索引并调用 DisplayCurrentPage 即可。

!a href="/static-assets/pdf/blog/vb-net-display-pdf-in-picture-box/vb-net-display-pdf-in-picture-box-4.webp">VB .NET Display PDF in PictureBox：在 Windows 窗体中将 PDF 页面渲染为图像：图像 4 - 使用我们的按钮导航到第 2 页。

如何使用查看器保存和打印 PDF 页面？

文档查看器通常需要支持将当前页面保存为图像文件以及将文档发送到打印机这两个功能。 IronPDF 让这两件事都变得简单易行。

private void btnSave_Click(object sender, EventArgs e)
{
    if (pictureBoxPdf.Image == null) return;

    using SaveFileDialog saveDialog = new SaveFileDialog();
    saveDialog.Filter = "PNG Image|*.png|JPEG Image|*.jpg|TIFF Image|*.tif";
    saveDialog.Title = "Save Page As Image";
    saveDialog.FileName = $"page_{currentPageIndex + 1}";

    if (saveDialog.ShowDialog() == DialogResult.OK)
    {
        pictureBoxPdf.Image.Save(saveDialog.FileName);
    }
}

private void btnSave_Click(object sender, EventArgs e)
{
    if (pictureBoxPdf.Image == null) return;

    using SaveFileDialog saveDialog = new SaveFileDialog();
    saveDialog.Filter = "PNG Image|*.png|JPEG Image|*.jpg|TIFF Image|*.tif";
    saveDialog.Title = "Save Page As Image";
    saveDialog.FileName = $"page_{currentPageIndex + 1}";

    if (saveDialog.ShowDialog() == DialogResult.OK)
    {
        pictureBoxPdf.Image.Save(saveDialog.FileName);
    }
}

Private Sub btnSave_Click(sender As Object, e As EventArgs)
    If pictureBoxPdf.Image Is Nothing Then Return

    Using saveDialog As New SaveFileDialog()
        saveDialog.Filter = "PNG Image|*.png|JPEG Image|*.jpg|TIFF Image|*.tif"
        saveDialog.Title = "Save Page As Image"
        saveDialog.FileName = $"page_{currentPageIndex + 1}"

        If saveDialog.ShowDialog() = DialogResult.OK Then
            pictureBoxPdf.Image.Save(saveDialog.FileName)
        End If
    End Using
End Sub

private void btnPrint_Click(object sender, EventArgs e)
{
    if (currentPdf == null) return;

    using PrintDialog printDialog = new PrintDialog();
    if (printDialog.ShowDialog() == DialogResult.OK)
    {
        currentPdf.Print();
    }
}

private void btnPrint_Click(object sender, EventArgs e)
{
    if (currentPdf == null) return;

    using PrintDialog printDialog = new PrintDialog();
    if (printDialog.ShowDialog() == DialogResult.OK)
    {
        currentPdf.Print();
    }
}

Private Sub btnPrint_Click(sender As Object, e As EventArgs)
    If currentPdf Is Nothing Then Return

    Using printDialog As New PrintDialog()
        If printDialog.ShowDialog() = DialogResult.OK Then
            currentPdf.Print()
        End If
    End Using
End Sub

如何正确处理和处置内存？

PDF 文档和渲染的位图会占用大量内存，尤其是在 DPI 设置较高或文档较大时。 如果没有妥善处置，长时间运行的查看器应用程序会逐渐耗尽可用内存。

protected override void Dispose(bool disposing)
{
    if (disposing)
    {
        currentPdf?.Dispose();
        pictureBoxPdf.Image?.Dispose();

        if (pageImages != null)
        {
            foreach (var bitmap in pageImages)
                bitmap.Dispose();
        }

        components?.Dispose();
    }
    base.Dispose(disposing);
}

protected override void Dispose(bool disposing)
{
    if (disposing)
    {
        currentPdf?.Dispose();
        pictureBoxPdf.Image?.Dispose();

        if (pageImages != null)
        {
            foreach (var bitmap in pageImages)
                bitmap.Dispose();
        }

        components?.Dispose();
    }
    base.Dispose(disposing);
}

Protected Overrides Sub Dispose(disposing As Boolean)
    If disposing Then
        currentPdf?.Dispose()
        pictureBoxPdf.Image?.Dispose()

        If pageImages IsNot Nothing Then
            For Each bitmap In pageImages
                bitmap.Dispose()
            Next
        End If

        components?.Dispose()
    End If
    MyBase.Dispose(disposing)
End Sub

如何只渲染可见页面而不是所有页面？

对于包含几十页甚至几百页的大型 PDF 文件，使用 ToBitmap 预先渲染所有页面可能速度很慢且占用大量内存。更高效的做法是按需渲染用户想要查看的页面。

IronPDF 的RasterizeToImageFiles方法支持逐页渲染，但对于内存使用，您也可以使用 PageCount 并一次渲染一个页面：

private void DisplayPageLazy(int pageIndex)
{
    if (currentPdf == null) return;

    // Render only the requested page
    AnyBitmap[] singlePage = currentPdf.ToBitmap(150, pageIndex, pageIndex);

    System.Drawing.Bitmap bitmap = singlePage[0].ToImage<System.Drawing.Bitmap>();
    pictureBoxPdf.Image?.Dispose();
    pictureBoxPdf.Image = bitmap;

    singlePage[0].Dispose();

    lblPageInfo.Text = $"Page {pageIndex + 1} of {currentPdf.PageCount}";
    UpdateNavigationState();
}

private void DisplayPageLazy(int pageIndex)
{
    if (currentPdf == null) return;

    // Render only the requested page
    AnyBitmap[] singlePage = currentPdf.ToBitmap(150, pageIndex, pageIndex);

    System.Drawing.Bitmap bitmap = singlePage[0].ToImage<System.Drawing.Bitmap>();
    pictureBoxPdf.Image?.Dispose();
    pictureBoxPdf.Image = bitmap;

    singlePage[0].Dispose();

    lblPageInfo.Text = $"Page {pageIndex + 1} of {currentPdf.PageCount}";
    UpdateNavigationState();
}

Private Sub DisplayPageLazy(pageIndex As Integer)
    If currentPdf Is Nothing Then Return

    ' Render only the requested page
    Dim singlePage As AnyBitmap() = currentPdf.ToBitmap(150, pageIndex, pageIndex)

    Dim bitmap As System.Drawing.Bitmap = singlePage(0).ToImage(Of System.Drawing.Bitmap)()
    pictureBoxPdf.Image?.Dispose()
    pictureBoxPdf.Image = bitmap

    singlePage(0).Dispose()

    lblPageInfo.Text = $"Page {pageIndex + 1} of {currentPdf.PageCount}"
    UpdateNavigationState()
End Sub

ToBitmap(dpi, startPage, endPage) 重载渲染特定范围的页面。 通过为 startPage 和 endPage 传递相同的索引，每次只渲染一个页面。这虽然会牺牲每次导航的渲染时间，但可以降低峰值内存使用量，对于非常大的文档来说，这种做法是值得的。

有关 IronPDF 图像输出功能的更多信息，请参阅PDF 转图像文档和PDF 光栅化指南。

一个实用的PDF查看器还应该允许用户放大内容和旋转页面。 对于缩放，动态调整传递给 ToBitmap 的 DPI -- 存储一个 currentDpi 字段（从 150 开始），在缩放按钮点击时将其增加或减少 50，然后使用更新后的 DPI 调用延迟页面渲染器。 更高的 DPI 会产生更大的图像，PictureBox 在 Zoom 模式下会缩放图像以适应控件。 使用 Math.Min 和 Math.Max 将 DPI 范围限制在 72 到 400 DPI 之间，以避免低端输出模糊或高端内存消耗过大。

有关更高级的渲染选项，包括从 PDF 中提取文本以及图像渲染，请参阅PDF 文本提取指南和PDF 图像提取文档。

您还可以探索 IronPDF 对合并 PDF 文档、添加水印、旋转 PDF 页面和添加注释等功能的支持，这些功能在更高级的查看器中也能实现。

如何为 Windows Forms 选择合适的 PDF 渲染库？

在为 Windows Forms 选择 PDF 渲染库时，有多种选择。以下是一个简单的比较，可帮助您评估各种选项：

IronPDF 在 Windows Forms 用例中的主要优势在于它是完全独立的——无需在最终用户的计算机上安装任何外部软件。 IronPDF 的许可页面详细介绍了定价和免费试用选项。 您可以在NuGet.org上找到该软件包，以及下载统计信息和版本历史记录。 要深入了解 PDF 规范如何定义页面渲染，ISO 发布的ISO 32000-2 PDF 标准描述了 IronPDF 和其他渲染器必须实现的格式。

要了解 IronPDF 除了图像渲染之外的其他功能，请参阅IronPDF 文档主页，其中涵盖了 PDF 创建、HTML 到 PDF 的转换、表单处理、数字签名等等。

下一步计划是什么？

本教程中所示的模式——使用 ToBitmap 渲染，使用 PictureBox 显示，使用基于索引的控件导航——为您提供了一个功能齐全、无依赖项的 Windows Forms PDF 查看器。 从这里出发，根据您的应用程序需求，有几个方向值得探索。

对于生产级查看器，可以考虑使用延迟页面渲染来高效处理大型文档，在主查看器旁边添加可滚动缩略图面板，并显示与 DPI 参数关联的缩放控件。 对于文档管理应用程序，将查看器与 IronPDF 的文本提取和表单字段读取功能相结合，以构建可搜索的文档索引。

如果您的工作流程涉及在显示 PDF 之前以编程方式生成 PDF，IronPDF 还支持HTML 到 PDF 的转换以及从头开始创建 PDF ，因此同一个库可以处理生成和查看。

开始免费试用，获取用于开发的无水印许可证密钥，或查看完整的 API 参考，了解 PdfDocument、AnyBitmap 和支持的渲染类中可用的所有方法。 IronPDF 示例库还提供了可直接运行的代码示例，涵盖了 C# 中的常见 PDF 任务。