C#將圖像添加到PDF（開發者教程）

建立或開啟 C# 項目

若要為 PDF 文件中新增影像，建議使用最新版本的 Visual Studio 建立 C# 項目，以獲得流暢的體驗。

開啟 Visual Studio。

Visual Studio 啟動 UI

點擊"建立新項目"按鈕。

• 從專案範本中選擇"C# 控制台應用程式"，然後按一下"下一步"按鈕。 您可以根據自己的需求選擇平台。

在 Visual Studio 中建立控制台應用程式

接下來，為你的專案命名，然後點擊"下一步"按鈕。

• 選擇目標.NET Framework >= .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。 請造訪以下ImageUtilities 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 表單。