IronPDF 提供更简单的图像添加，代码更少和永久许可证，而 iText 提供更细粒度的控制但需要更多代码，并且在商业应用上具有复杂的 AGPL 许可。
在.NET环境中处理PDF文件时，向文档添加图像是许多应用程序的常见需求。 无论您是生成带有公司徽标的发票、创建带有嵌入式图表的报告，还是制作带有水印的自定义文档，将图像嵌入 PDF 的功能都至关重要。 在 C# 中两个流行的 PDF 库是IronPDF 和 iText。 本文从易用性、性能、许可模式以及图像压缩和格式支持等高级功能等方面，对这两个库在向 PDF 添加图像方面的能力进行了比较。
IronPDF： IronPDF 简化了向 PDF 添加图像的操作，内置支持来自 URL 的本地图像和远程图像。 其 API 提供对位置、宽度和缩放的控制。 该库支持 JPEG、PNG、GIF、 SVG和WebGL 内容。 印章功能提供了添加水印、信头和叠加图像的方法。 Chrome渲染引擎可确保复杂图形和响应式图像的精确渲染。
iText: iText 通过其较低层次的 API 提供图像嵌入。 它提供了一个灵活的接口，可以处理 JPG 和 PNG 格式。 但是，自定义需要更多代码，尤其是在精确定位图像或实现透明度和旋转时。 该库需要手动处理坐标系和比例计算。 为了实现响应式尺寸，您通常需要实现自己的视口控件。
IronPDF: IronPDF 通过改进后的内存管理高效处理大型 PDF 和图像。 在生成或修改带有嵌入式图形的 PDF 时性能优异，适用于服务器应用程序和Azure 部署。 该库支持异步操作和多线程批量处理。 性能优化功能包括智能缓存和并行 PDF 生成。
iText: 在处理大型文件或复杂的图像操作时，iText 可能会较慢。 当同时处理多张图像或处理高分辨率图像时，内存使用情况会成为一个问题。 但是，只要配置得当，它仍然适用于大多数应用场景。 该库缺少针对批量操作的内置压缩优化功能。
IronPDF： IronPDF 提供永久许可证，一次性购买即可享受透明定价。 这样可以避免产生持续的订阅费用。 该图书馆提供免费试用选项和完整的技术支持。 许可证密钥管理非常简单，提供多种配置选项。
iText: iText 使用 AGPL 用于开源使用，要求源代码发布。 商业许可证可以免除这项要求。 许可的复杂性可能会给商业应用带来挑战。 了解许可证升级和延期需要周密的计划。
通过NuGet将 IronPDF 安装到您的 C# 或 Visual Basic 项目中。 该库支持多种安装方法，包括Windows Installer和Docker 部署：
PM > Install-Package IronPdf
安装完成后，您可以使用 IronPDF 的API 参考开始添加图像。 该库可在Windows 、 Linux和macOS平台上无缝运行。
快速入门：使用 IronPDF 向 PDF 添加图像 AH2BG 快速入门：使用 IronPDF 向 PDF 添加图像 AH2EG 快速入门 using IronPDF 的印章 API 向 PDF 添加图像只需要编写极少的代码。
PM > Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;
class Program
{
public static void Main(string[] args)
{
// Create a renderer to convert HTML to PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Render a basic PDF with some HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
// Create an ImageStamper with the image URL
ImageStamper stamper = new ImageStamper(new Uri("___PROTECTED_URL_61___"));
// Configure image position and size
stamper.HorizontalAlignment = HorizontalAlignment.Center;
stamper.VerticalAlignment = VerticalAlignment.Middle;
stamper.Width = 200; // Width in pixels
stamper.Height = 100; // Height in pixels
// Apply the stamp (image) to the PDF document
pdf.ApplyStamp(stamper);
// Save the modified PDF to a file
pdf.SaveAs("output.pdf");
}
}
IronPDF 擅长为现有 PDF 添加水印和背景图像。 该库支持多种冲压操作和自定义定位：
using IronPdf;
using IronPdf.Editing;
// Load an existing PDF
PdfDocument pdf = PdfDocument.FromFile("invoice.pdf");
// Create a watermark with transparency
ImageStamper watermark = new ImageStamper("watermark.png")
{
Opacity = 30, // 30% opacity for subtle watermarking
Rotation = -45, // Diagonal watermark
HorizontalAlignment = HorizontalAlignment.Center,
VerticalAlignment = VerticalAlignment.Middle
};
// Apply watermark to all pages
pdf.ApplyStamp(watermark);
// Add a header logo
ImageStamper logo = new ImageStamper("company-logo.png")
{
HorizontalOffset = Length.Millimeters(10),
VerticalOffset = Length.Millimeters(10),
Width = 150,
Height = 50
};
pdf.ApplyStamp(logo, PageSelection.FirstPage);
pdf.SaveAs("watermarked-invoice.pdf");Imports IronPdf
Imports IronPdf.Editing
' Load an existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("invoice.pdf")
' Create a watermark with transparency
Dim watermark As New ImageStamper("watermark.png") With {
.Opacity = 30, ' 30% opacity for subtle watermarking
.Rotation = -45, ' Diagonal watermark
.HorizontalAlignment = HorizontalAlignment.Center,
.VerticalAlignment = VerticalAlignment.Middle
}
' Apply watermark to all pages
pdf.ApplyStamp(watermark)
' Add a header logo
Dim logo As New ImageStamper("company-logo.png") With {
.HorizontalOffset = Length.Millimeters(10),
.VerticalOffset = Length.Millimeters(10),
.Width = 150,
.Height = 50
}
pdf.ApplyStamp(logo, PageSelection.FirstPage)
pdf.SaveAs("watermarked-invoice.pdf")您还可以创建包含多张图片的复杂布局：
// Add images from Base64 strings
string base64Image = Convert.ToBase64String(File.ReadAllBytes("signature.png"));
HtmlStamper signatureStamp = new HtmlStamper($"<img src='data:image/png;base64,{base64Image}'/>");
signatureStamp.HorizontalAlignment = HorizontalAlignment.Right;
signatureStamp.VerticalAlignment = VerticalAlignment.Bottom;
pdf.ApplyStamp(signatureStamp);Imports System
Imports System.IO
' Add images from Base64 strings
Dim base64Image As String = Convert.ToBase64String(File.ReadAllBytes("signature.png"))
Dim signatureStamp As New HtmlStamper($"<img src='data:image/png;base64,{base64Image}'/>")
signatureStamp.HorizontalAlignment = HorizontalAlignment.Right
signatureStamp.VerticalAlignment = VerticalAlignment.Bottom
pdf.ApplyStamp(signatureStamp)
本示例使用ChromePdfRenderer类从HTML 字符串渲染新的 PDF。 使用 IronPDF 的图像盖章工具，您可以从提供的 URL 创建图像并将其应用到 PDF 中。 这演示了如何用最少的代码向PDF 页面添加图像。 渲染选项可让您完全控制输出质量。
IronPDF 为图像放置提供了广泛的自定义选项。 您可以通过印章工具的定位功能设置对齐方式和偏移量来指定页面位置。 该库支持使用坐标进行绝对定位和使用对齐选项进行相对定位。 高级功能包括自定义纸张尺寸和边距控制，以实现精确的布局。
通过 NuGet 安装 iText。 与 IronPDF 的完整平台支持不同，iText 的部署选项有限：
PM > Install-Package itext7
配置完成后，继续使用 iText 的文档操作功能来添加图像。 该库需要额外的配置才能进行字体管理和UTF-8 支持。
以下是在 iText 中插入图像的方法:
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;
class Program
{
public static void Main(string[] args)
{
// Initialize PDF writer
var pdfWriter = new PdfWriter("output.pdf");
// Initialize PDF document
var pdfDocument = new iText.Kernel.Pdf.PdfDocument(pdfWriter);
// Initialize document
var document = new Document(pdfDocument);
// Create ImageData from image file
ImageData imageData = ImageDataFactory.Create("iText.png");
// Create an Image instance
Image image = new Image(imageData);
// Set fixed position for the image in the PDF
image.SetFixedPosition(50, 100); // x, y coordinates
// Scale image to fit within specified dimensions
image.ScaleToFit(200, 200); // Width, Height
// Add image to document
document.Add(image);
// Close the document
document.Close();
}
}Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.Layout.Element
Imports iText.IO.Image
Module Program
Sub Main(args As String())
' Initialize PDF writer
Dim pdfWriter = New PdfWriter("output.pdf")
' Initialize PDF document
Dim pdfDocument = New iText.Kernel.Pdf.PdfDocument(pdfWriter)
' Initialize document
Dim document = New Document(pdfDocument)
' Create ImageData from image file
Dim imageData As ImageData = ImageDataFactory.Create("iText.png")
' Create an Image instance
Dim image As New Image(imageData)
' Set fixed position for the image in the PDF
image.SetFixedPosition(50, 100) ' x, y coordinates
' Scale image to fit within specified dimensions
image.ScaleToFit(200, 200) ' Width, Height
' Add image to document
document.Add(image)
' Close the document
document.Close()
End Sub
End Module对于创建产品目录或相册等复杂场景，您需要手动管理布局。 IronPDF的目录功能和书签支持可以整理多页文档：
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;
using iText.Layout.Properties;
// Create a grid of images
var pdfWriter = new PdfWriter("catalog.pdf");
var pdfDocument = new PdfDocument(pdfWriter);
var document = new Document(pdfDocument);
// Add images in a grid layout
float xPosition = 50;
float yPosition = 750;
int imagesPerRow = 3;
int currentImage = 0;
string[] imageFiles = { "product1.jpg", "product2.jpg", "product3.jpg",
"product4.jpg", "product5.jpg", "product6.jpg" };
foreach (string imagePath in imageFiles)
{
ImageData imageData = ImageDataFactory.Create(imagePath);
Image image = new Image(imageData);
// Calculate position
int column = currentImage % imagesPerRow;
int row = currentImage / imagesPerRow;
float x = xPosition + (column * 180);
float y = yPosition - (row * 250);
image.SetFixedPosition(x, y);
image.ScaleToFit(150, 200);
document.Add(image);
currentImage++;
}
document.Close();Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.Layout.Element
Imports iText.IO.Image
Imports iText.Layout.Properties
' Create a grid of images
Dim pdfWriter As New PdfWriter("catalog.pdf")
Dim pdfDocument As New PdfDocument(pdfWriter)
Dim document As New Document(pdfDocument)
' Add images in a grid layout
Dim xPosition As Single = 50
Dim yPosition As Single = 750
Dim imagesPerRow As Integer = 3
Dim currentImage As Integer = 0
Dim imageFiles As String() = {"product1.jpg", "product2.jpg", "product3.jpg",
"product4.jpg", "product5.jpg", "product6.jpg"}
For Each imagePath As String In imageFiles
Dim imageData As ImageData = ImageDataFactory.Create(imagePath)
Dim image As New Image(imageData)
' Calculate position
Dim column As Integer = currentImage Mod imagesPerRow
Dim row As Integer = currentImage \ imagesPerRow
Dim x As Single = xPosition + (column * 180)
Dim y As Single = yPosition - (row * 250)
image.SetFixedPosition(x, y)
image.ScaleToFit(150, 200)
document.Add(image)
currentImage += 1
Next
document.Close()
图片被添加到坐标 (50, 100) 处，并缩放至 200x200 像素大小。 PdfWriter 创建输出文件，启用PDF 编写者功能以处理图像。 为了更好地组织内容，可以考虑使用页码和页眉/页脚。
iText 通过手动坐标计算提供位置和大小控制。 您可以缩放图像，同时保持宽高比，或者拉伸到特定尺寸。 SetFixedPosition 方法提供精确的定位控制，您还可以操控对齐和旋转。 但是，它缺少 IronPDF 的视口控制和响应式尺寸选项。
这两个库在处理向 PDF 添加图像方面存在显著差异：
IronPDF 经过改进，以提高性能，高效处理包含多图的大型文档。 它能更快地渲染 PDF 文件，尤其适用于图形密集型文档。 该库支持异步操作和并行处理，以提高吞吐量。 内存流操作可减少磁盘 I/O，从而提高性能。
iText 提供良好的性能，但在处理非常大的 PDF 或大量高分辨率图像时可能遇到困难。 虽然效率很高，但一些开发人员反映，在涉及多个页面操作的复杂用例中，渲染速度比 IronPDF 慢。 该库缺乏用于网页优化的内置线性化支持。
IronPDF支持所有图像格式：
iText 支持标准格式：
IronPDF提供内置的压缩选项，可在文件大小和质量之间取得平衡。 该库提供数据清理功能和数据扁平化功能：
// Configure compression when rendering
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.JpegQuality = 85; // 0-100 quality scale
// Compress existing PDFs with images
PdfDocument pdf = PdfDocument.FromFile("large-images.pdf");
pdf.CompressImages(60); // Compress to 60% quality
pdf.SaveAs("compressed.pdf");
// Additional optimization options
renderer.RenderingOptions.GrayScale = true; // Convert to grayscale
renderer.RenderingOptions.DPI = 150; // Reduce DPI for web viewingImports IronPdf
' Configure compression when rendering
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.JpegQuality = 85 ' 0-100 quality scale
' Compress existing PDFs with images
Dim pdf As PdfDocument = PdfDocument.FromFile("large-images.pdf")
pdf.CompressImages(60) ' Compress to 60% quality
pdf.SaveAs("compressed.pdf")
' Additional optimization options
renderer.RenderingOptions.GrayScale = True ' Convert to grayscale
renderer.RenderingOptions.DPI = 150 ' Reduce DPI for web viewingiText 需要通过图像数据操作来手动处理压缩，从而增加质量控制的实施复杂性。 您必须自行实现灰度转换和DPI调整。
IronPDF 提供可靠的图像提取功能：
// Extract all images from a PDF
PdfDocument pdf = PdfDocument.FromFile("document.pdf");
var images = pdf.ExtractAllImages();
foreach (var image in images)
{
// Save extracted images
image.SaveAs($"extracted_image_{images.IndexOf(image)}.png");
}
// Extract images from specific pages
var pageImages = pdf.ExtractImagesFromPage(0); // First pageImports System
' Extract all images from a PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")
Dim images = pdf.ExtractAllImages()
For Each image In images
' Save extracted images
image.SaveAs($"extracted_image_{images.IndexOf(image)}.png")
Next
' Extract images from specific pages
Dim pageImages = pdf.ExtractImagesFromPage(0) ' First pageIronPDF： IronPDF 提供简单直接的永久许可证，只需一次性购买。 这种方法具有明显的优势，可以避免持续的成本或开源许可要求。 该库提供全面的支持和定期更新。 许可证验证是自动化的，并支持多种部署场景。
iText: iText 遵循 AGPL 许可证，免费用于开源项目，但要求发布网页应用的公共源代码。 商业许可不受AGPL限制。 许可模式可能会使云部署变得复杂。
IronPDF 和 iText 都为 C# 中的 PDF 添加图像提供了有效的工具，各有独特的优势。 IronPDF 以易用性、性能和许可灵活性著称，是处理复杂 PDF 和图像的理想选择，且代码量极少。 它为大型 PDF 文件提供了更好的可扩展性，并提供一次性购买许可，避免了重复性成本或复杂的开源限制。
该库支持SVG和 WebP 等现代格式，并具有内置压缩功能和直观的定位 API，适合需要高质量文档生成的企业应用程序。 IronPDF 的Chrome 渲染引擎可确保在所有平台上实现像素级完美输出。
iText适合开源项目，尽管需要更多代码才能获得相同的结果，并可能在面对更大的PDF时陷入性能问题。 其底层 API 提供精细的控制，但增加了开发复杂性。 该库缺少响应式 CSS 支持和JavaScript 渲染等现代功能。
对于企业应用而言，IronPDF 的优势包括Docker 支持、 AWS Lambda 兼容性和Azure Functions 集成。 该图书馆还提供符合监管要求的PDF/A 合规性和PDF/UA 可访问性。
想要简化您的 PDF 图片处理流程吗？ IronPDF 可以用最少的代码高效地将图片添加到 PDF 中。 试用IronPDF ，体验在 C# 项目中简化图像集成。 实现为您处理了复杂性，节省时间并改进PDF 生成工作流。 探索完整的功能集，加入数千名简化 PDF 操作的开发者行列。
Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.
当您需要PDF看起来像HTML时，速度快。
