Stamp Text & Image on PDFs using C# and IronPDF

输出的 PDF 是什么样子？

如何创建多行文本印章？

在 TextStamper 中使用 <br> 标签表示多行文本。 例如，"行 1
行 2 "在第一行产生 "行 1"，在第二行产生 "行 2"。这样就可以创建地址戳或多行水印。

图章输出是什么样的？

支持哪些图像格式？

ImageStamper 支持通过 URI 引用或文件路径来传输 PNG、JPEG、GIF 和 SVG 文件。 确保远程图像的正确网络连接。 对于 Azure 环境，可考虑使用 来自 Azure Blob Storage 的图像。

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

我可以混合使用不同类型的印章吗？

ApplyMultipleStamps 接受包含任何印章类型的数组。将 HTMLStamper 和 BarcodeStamper 合并到一个操作中。 同时创建带有页眉、页脚、水印和识别码的复杂文档布局。

关键定位属性是什么？

• HorizontalAlignment: 相对于页面的水平对齐方式。 默认值：HorizontalAlignment.Center。
• VerticalAlignment: 相对于页面的垂直对齐方式。 默认值：VerticalAlignment.Middle。
• HorizontalOffset: 水平偏移。 默认值：0，单位：MeasurementUnit.Percentage。 正值向右偏移，负值向左偏移。
• VerticalOffset: 垂直偏移。 默认值：0，单位：MeasurementUnit.Percentage。 正值向下偏移，负值向上偏移。

如何设置精确偏移？

使用 Length 类指定 HorizontalOffset 和 VerticalOffset。 默认计量单位为百分比。 可用单位包括英寸、毫米、厘米、像素和点。 这样就可以实现精确定位，如在 PDF 文档中设置自定义页边距。

代码

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs

using IronPdf.Editing;
using System;

// Create text stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};

代码

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

pdf.SaveAs("multipleStamps.pdf");

哪些是基本的 HTML Stamper 属性？

• Html: 要添加到 PDF 中的 HTML 片段。 对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 设计配合使用。

代码

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

pdf.SaveAs("stampText.pdf");

条形码有哪些配置选项？

• Value: 条形码的字符串值。
• BarcodeType: 支持 QRCode、Code128 和 Code39 的编码类型。默认值：QRCode。
• Width: 以像素为单位的渲染条形码宽度。 默认值：250px。
• Height: 以像素为单位的渲染条形码高度。 默认值：250px。

何时使用每种条形码类型？

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

如何控制印章外观？

• Opacity: 控制透明度。 0 表示不可见，100 表示不透明。
• Rotation: 将印章顺时针旋转 0 到 360 度。
• MaxWidth: 输出戳记的最大宽度。
• MaxHeight: 输出戳记的最大高度。
• MinWidth: 输出戳记的最小宽度。
• MinHeight: 输出戳记的最小高度。
• Hyperlink: 为带戳记的元素添加点击超链接。 注意：HTML 链接(a 标记)不会因加盖戳记而被保留。
• Scale: 对邮票应用百分比刻度。 默认值：100(无影响)。
• IsStampBehindContent: 将印章放置在内容后面。 如果内容不透明，则可能看不到图章。
• WaitFor: 等待事件或时间。请参阅使用 WaitFor 延迟 PDF 渲染。
• Timeout: 渲染超时时间(秒)。 默认值：60。

哪些属性最常用？

Opacity 和 IsStampBehindContent 创建水印。 Scale 和 Rotation 调整视觉定位和大小。 例:

// 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
};

// 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
};