C#添加图像到PDF（开发者教程）

创建或打开C#项目

要向PDF文档中添加图像，推荐使用最新版本的Visual Studio创建C#项目以获得流畅的体验。

• 打开Visual Studio。

Visual Studio启动UI

• 点击"创建新项目"按钮。
• 从项目模板中选择"C#控制台应用程序"，然后点击下一步按钮。 你可以根据你的需要选择一个平台。

在Visual Studio中创建控制台应用程序

• 接下来，为你的项目命名并点击下一步按钮。
• 选择目标.NET框架 >= .NET Core 3.1版本，并点击创建按钮。

按照上述步骤，你就可以轻松创建一个新的C#项目。 你可以使用已经存在的C#项目。 只需打开项目并安装IronPDF库。

安装IronPDF库

Install-Package IronPdf

using IronPdf;

using IronPdf;

将位图和图像添加到PDF文档中

使用IronPDF向 PDF 文档添加图像有多种方法：使用直接图像文件、将图像转换为字节，或使用 System.Drawing.Bitmap。 此外，IronPDF库支持多种图像格式。

让我们来看看：

using IronPdf;
using System.IO;
using System.Drawing;

class PDFImageAdder
{
    /* This method demonstrates how to convert an image file to a PDF document in C# */
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Read the PNG image file into binary format
        var pngBinaryData = File.ReadAllBytes("embed_me.png");

        // Convert image binary data to base64 for embedding in HTML
        var ImgDataURI = "data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

        // Embed the image as a base64 data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{ImgDataURI}'>";

        // Render the HTML as a PDF document
        using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the rendered PDF document
        pdfdoc.SaveAs("embedded_example_1.pdf");
    }
}

using IronPdf;
using System.IO;
using System.Drawing;

class PDFImageAdder
{
    /* This method demonstrates how to convert an image file to a PDF document in C# */
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Read the PNG image file into binary format
        var pngBinaryData = File.ReadAllBytes("embed_me.png");

        // Convert image binary data to base64 for embedding in HTML
        var ImgDataURI = "data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

        // Embed the image as a base64 data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{ImgDataURI}'>";

        // Render the HTML as a PDF document
        using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the rendered PDF document
        pdfdoc.SaveAs("embedded_example_1.pdf");
    }
}

该程序首先会加载图像。上述代码中的 ReadAllBytes 函数会将图像转换为字节格式。 之后，图像数据将被编码为 base64，并作为字符串放入 HTML <img> 标签中。 之后，将使用RenderHtmlAsPdf 方法函数将 HTML 字符串渲染为 PDF。 它将在PDF文档中创建一个PDF页面。

下一个示例将展示如何在PDF文档中使用位图图像。 IronPDF提供了一种有用的方法，可以将 System.Drawing.Image 嵌入到 HTML 文档中，然后可以将其渲染为 PDF。 访问以下图像工具API以了解更多信息。 下面的代码将展示它是如何工作的：

using IronPdf;
using System.Drawing;

class PDFImageAdder
{
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Create a Bitmap image
        Bitmap MyImage = new Bitmap("Path-to-Your-Image");

        // Convert the Bitmap image to a Data URI
        string DataURI = IronPdf.Util.ImageToDataUri(MyImage);

        // Embed the image as a Data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{DataURI}'>";

        // Render the HTML to PDF
        using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the PDF document
        pdfdoc2.SaveAs("embedded_example_2.pdf");
    }
}

using IronPdf;
using System.Drawing;

class PDFImageAdder
{
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Create a Bitmap image
        Bitmap MyImage = new Bitmap("Path-to-Your-Image");

        // Convert the Bitmap image to a Data URI
        string DataURI = IronPdf.Util.ImageToDataUri(MyImage);

        // Embed the image as a Data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{DataURI}'>";

        // Render the HTML to PDF
        using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the PDF document
        pdfdoc2.SaveAs("embedded_example_2.pdf");
    }
}

在上面的代码中，ImageToDataUri 函数用于将图像转换为 URI 格式。 然后使用 RenderHtmlAsPdf 函数在 PDF 文档中绘制图像。 这适用于多个图像。

此外，IronPDF还能够在PDF中呈现图表、向PDF文档添加条形码、通过密码增强PDF安全性和水印PDF文件，甚至可以以编程方式处理PDF表单。