使用 C# 和 IronPDF 在 PDF 上标注文本和图像。

已更新:一月 10, 2026

Translated

View the article in English

IronPDF 使用 TextStamper, ImageStamper, HTMLStamper 和 BarcodeStamper 类在 C# 中以精确的定位控制将文本、图像、HTML 内容和条形码标记到现有的 PDF 文档上。

<！--说明：说明代码概念的图表或截图 -->

在现有 PDF 文档上覆盖附加内容。印章可为 PDF 添加信息、标签、水印或注释。利用 IronPDF 的全面印章功能，将印章用于添加页眉和页脚或创建自定义水印。

IronPDF 提供四种戳记器：<代码>TextStamper</代码>、<代码>ImageStamper</代码>、<代码>HTMLStamper</代码>和<代码>BarcodeStamper</代码>。 HTMLStamper利用带有 CSS 样式的所有 HTML 功能，类似于将 HTML 字符串转换为 PDF。

快速入门：立即在 PDF 上添加文本水印

使用 IronPDF 的 TextStamper 类为 PDF 文档添加文本注释、水印或标签。下面的示例演示了使用 ApplyStamp 方法将文本加盖到 PDF 上。

使用 NuGet 包管理器安装 IronPDF

PM > Install-Package IronPdf

复制并运行这段代码。

var pdf = new IronPdf.PdfDocument("input.pdf");
var stamper = new IronPdf.Editing.TextStamper()
{
    Text = "Confidential",
    FontSize = 50,
    Opacity = 50,
    VerticalAlignment = IronPdf.Editing.VerticalAlignment.Middle,
    HorizontalAlignment = IronPdf.Editing.HorizontalAlignment.Center
};
pdf.ApplyStamp(stamper);
pdf.SaveAs("stamped.pdf");

部署到您的生产环境中进行测试

立即开始在您的项目中使用 IronPDF，免费试用！

免费试用30天

最小工作流程（5 个步骤）

下载 C# 库以在文本和图像上盖章。
创建并配置所需的印戳类
使用 ApplyStamp 方法将图章应用到 PDF 中
使用 ApplyMultipleStamps 方法应用多个图章
指定特定页面以应用印戳

如何在 PDF 上加印文本？ <！--说明：说明代码概念的图表或截图 --> 创建一个包含所有显示配置的 `TextStamper` 对象。将 `TextStamper` 对象传递给 `ApplyStamp` 方法。 `Text` 属性设置显示的文本。配置字体系列、字体样式和印章位置。 `TextStamper`提供了广泛的自定义选项，类似于在 PDF 文档中[管理字体](https://ironpdf.com/how-to/manage-fonts/)。将 `UseGoogleFont` 设置为 true，即可使用系统字体或 Google 字体。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs ```

输出的 PDF 是什么样子？

如何创建多行文本印章？在 `TextStamper` 中使用 `
` 标记来处理多行文本。例如，"行 1
行 2 "在第一行产生 "行 1"，在第二行产生 "行 2"。这样就可以创建地址戳或多行水印。

如何在 PDF 上加盖图像？创建一个 `ImageStamper` 对象，并使用 `ApplyStamp` 方法将图像应用到文档。该方法的第二个参数接受一个页面索引，用于标记单个或多个页面。以下示例为 PDF 第 1 页的图片加盖了印章。 [{t:(所有页面索引均采用零基索引。对于复杂的图像操作，请探索 [ 将图像添加到 PDF](https://ironpdf.com/how-to/add-images-to-pdfs/) 或使用 [base64 编码图像](https://ironpdf.com/how-to/base-urls/)。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-image.cs ```

图章输出是什么样的？

支持哪些图像格式？ `ImageStamper`通过 URI 引用或文件路径支持 PNG、JPEG、GIF 和 SVG。确保远程图像的正确网络连接。对于 Azure 环境，可考虑使用 [来自 Azure Blob Storage 的图像](https://ironpdf.com/how-to/images-azure-blob-storage/)。

如何应用多个印章？使用 `ApplyMultipleStamps` 通过传递戳记数组来应用多个戳记。这种方法可以在一次操作中高效处理多个邮票。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs ```

当印章重叠时会发生什么？

我可以混合使用不同类型的印章吗？ `ApplyMultipleStamps` 接受包含任何印章类型的数组。在一次操作中结合 `TextStamper`, `ImageStamper`, `HTMLStamper` 和 `BarcodeStamper` 。同时创建带有页眉、页脚、水印和识别码的复杂文档布局。

如何控制图章位置？使用 3x3 网格（横向三列，纵向三行）定义图章位置。选择水平对齐方式：左对齐、居中对齐、右对齐。选择垂直对齐方式：上、中、下。调整水平和垂直偏移以实现精确定位。请参见下图，以获得直观的说明。

关键定位属性是什么？ - `HorizontalAlignment`：相对于页面的水平对齐方式。默认：`HorizontalAlignment.Center`。 - `VerticalAlignment`（垂直对齐方式）：相对于页面的垂直对齐方式。默认值：`VerticalAlignment.Middle`。 - `HorizontalOffset`：水平偏移。默认：0，单位：`MeasurementUnit.Percentage`。正值向右偏移，负值向左偏移。 - `VerticalOffset`：垂直偏移。默认：0，单位：`MeasurementUnit.Percentage`。正值向下偏移，负值向上偏移。

如何设置精确偏移？使用 `Length` 类指定 `HorizontalOffset` 和 `VerticalOffset` 。默认计量单位为百分比。可用单位包括英寸、毫米、厘米、像素和点。这样就可以实现精确定位，如在 PDF 文档中[设置自定义页边距](https://ironpdf.com/how-to/custom-margins/)。 ### 代码 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs ```

如何在 HTML 内容上盖章？使用 `HtmlStamper` 类对文本和图像进行标记。 `HtmlStamper`使用 CSS 样式渲染 HTML 设计，然后将其印制到 PDF 文档中。 `HtmlBaseUrl` 属性指定了 CSS 和图像文件等 HTML 字符串资产的基础 URL。这与 [ 将 HTML 转换为 PDF](https://ironpdf.com/how-to/html-string-to-pdf/) 使用相同的渲染引擎。 ### 代码 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs ```

哪些是基本的 HTML Stamper 属性？ - `Html`：将 HTML 片段印到 PDF 上。对 JavaScript、CSS 和图像的外部引用与 `HtmlBaseUrl` 相对。 - `HtmlBaseUrl`：外部 CSS、JavaScript 和图像文件引用的基础 URL。 - `CssMediaType`：启用 Media="screen" CSS 样式。设置 `AllowScreenCss=false` 可使用 CSS media="print" 渲染图章。默认：<代码>PdfCssMediaType.Screen。

为什么使用 HTML Stamper 而不是 Text Stamper？ `HTMLStamper`为复杂布局、多种字体、颜色和嵌入式图像提供完整的 HTML 和 CSS 支持。是丰富内容水印或标题的理想选择。保持一致的品牌形象，并与[响应式 CSS 设计](https://ironpdf.com/how-to/html-to-pdf-responsive-css/)配合使用。

如何给 BarCode 打印章？ `BarcodeStamper` 类可直接在现有 PDF 文档上加盖条形码。支持 QRCode、Code128 和 Code39 条码类型。 ### 代码 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs ```

条形码有哪些配置选项？ - `值`：条形码的字符串值。 - `BarcodeType`：支持 QRCode、Code128 和 Code39 的编码类型。默认值：QRCode。 - <代码>宽度：以像素为单位的渲染条形码宽度。默认值：250px。 - <代码>高度：渲染条形码的高度，单位为像素。默认值：250px。

何时使用每种条形码类型？ QRCode 可处理 URL 和大型数据集（最多可达 4296 个字母数字字符）。 `Code128` 适合高密度要求的字母数字数据。 `Code39` 适用于简单的数字或大写字母组合。选择条形码类型时要考虑扫描设备的兼容性。

还有哪些 Stamper 选项？这些属性提供了对图章外观和行为的精细控制，类似于 [创建自定义水印](https://ironpdf.com/how-to/custom-watermark/)。

如何控制印章外观？ - <代码>透明度：控制透明度。 0 表示不可见，100 表示不透明。 - <代码>旋转：从 0 到 360 度顺时针旋转图章。 - <代码>最大宽度：输出戳记的最大宽度。 - `MaxHeight`：输出图章的最大高度。 - `最小宽度`：输出戳记的最小宽度。 - <代码>最小高度：输出图章的最小高度。 - <代码>超链接：将单击超链接添加到加盖元素中。注意：HTML 链接（a 标记）不会因加盖戳记而被保留。 - <代码>刻度：对邮票应用百分比刻度。默认值：100（无影响）。 - `IsStampBehindContent`：在内容后面放置印章。如果内容不透明，则可能看不到图章。 - <代码>WaitFor：等待事件或时间。请参阅 [ 使用 WaitFor 延迟 PDF 呈现](https://ironpdf.com/how-to/waitfor/)。 - `Timeout`：渲染超时时间（以秒为单位）。默认值：60。

哪些属性最常用？ `Opacity` 和 `IsStampBehindContent` 可创建水印。 `Scale` 和 `Rotation` 可调整视觉定位和大小。例: ```csharp // Create a semi-transparent watermark behind content TextStamper watermark = new TextStamper() { Text = "CONFIDENTIAL", FontSize = 60, FontColorCode = "#CCCCCC", Opacity = 25, Rotation = -45, IsStampBehindContent = true, VerticalAlignment = VerticalAlignment.Middle, HorizontalAlignment = HorizontalAlignment.Center }; ``` ## 摘要 IronPdf 的盖章功能可在现有 PDF 文档中添加文本、图像、HTML 内容和条形码。四种具有广泛自定义选项的专业标注类可创建带有水印、页眉、页脚和注释的专业文档。带有各种测量单位和对齐选项的定位系统可确保像素完美定位。使用简单的文本图章或带有 CSS 风格的复杂 HTML 布局。 IronPDF 的戳记 API 为企业级 PDF 操作提供了灵活性和控制性。

常见问题解答

如何用 C# 在 PDF 文档中添加文本水印？

使用 IronPDF 的 TextStamper 类添加文本水印。创建一个 TextStamper 对象，设置 Text、FontSize 和 Opacity 等属性，然后使用 ApplyStamp 方法。您可以使用 VerticalAlignment 和 HorizontalAlignment 属性对水印进行定位，以便精确放置。

能否在现有 PDF 文件中添加图像作为图章？

是的，IronPDF 提供了 ImageStamper 类，用于向 PDF 添加图像。创建一个 ImageStamper 对象，指定图像文件，然后使用 ApplyStamp 方法。您可以使用基于零的页面索引来控制定位并指定要盖印的页面。

哪些类型的内容可以印制到 PDF 上？

IronPDF 支持四种类型的图章：TextStamper 用于文本注释和水印，ImageStamper 用于图像，HTMLStamper 用于具有完整 CSS 风格的 HTML 内容，BarcodeStamper 用于条形码。每个戳记类都提供精确的定位控制。

如何创建多行文本标记？

在 TextStamper 的 Text 属性中使用
标记来创建多行标记。例如，"line 1
line 2 "将在两个独立的行上显示文本，非常适合创建地址戳记或多行水印。

在 PDF 上印制文本时可以使用自定义字体吗？

是的，IronPDF 中的 TextStamper 支持系统字体和 Google 字体。将 UseGoogleFont 属性设为 true 即可使用 Google 字体，或使用 FontFamily 属性指定任何已安装的系统字体，以实现完全的排版控制。

是否可以只在特定页面上添加印章？

当然可以。ApplyStamp 方法接受一个页面索引参数，允许您对特定页面加盖戳记。IronPDF 使用基于零的索引，因此第 1 页为索引 0。您还可以使用 ApplyMultipleStamps 一次为多个页面添加图章。

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？

Nuget 下载 17,012,929 | 版本: 2025.12 刚刚发布

查看许可证

如何在C#中将印戳和水印添加到PDF

在 GitHub 上查看

代码

https://github.com/iron-software/IronPdf.Examples/tree/main/how-to/stamp-text-image

下载 ZIP

客户亮点：

开发者焦点：

网络研讨会：

本页内容

使用 C# 和 IronPDF 在 PDF 上标注文本和图像。

立即开始使用 NuGet 创建 PDF 文件：