IRONSOFTWAREHOME

Stamp Text & Image on PDFs using C# and IronPDF

Curtis Chau
Curtis Chau
Updated: 2026年6月3日

IronPDF使用BarcodeStamper類將文字、圖像、HTML內容和條形碼加蓋到現有的PDF文件中,並具有精確的定位控制。

加蓋是在現有的PDF文件上覆蓋附加內容。 加蓋可以在PDF上新增資訊、標籤、水印或註釋。 使用加蓋功能新增頁眉和頁腳或使用IronPDF的綜合加蓋功能建立自定義水印。

IronPDF提供四個加蓋器:BarcodeStamperHTMLStamper利用所有HTML功能並帶有CSS樣式,類似於將HTML字串轉換為PDF

快速入門:立即在PDF上加蓋文字

使用IronPDF的TextStamper類為PDF文件新增文字注釋、水印或標籤。 以下範例展示了使用ApplyStamp方法在PDF上加蓋文字。

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2複製並運行這段程式碼片段。

    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");
    C#
  3. 3部署以在您的實時環境中測試

    今天就開始在您的專案中使用IronPDF,透過免費試用
    arrow pointer

我如何在PDF上加蓋文字?

建立一個包含所有顯示配置的TextStamper物件。 將ApplyStamp方法。 Text屬性設置顯示的文字。 配置字體系列、字體樣式和加蓋位置。

TextStamper提供豐富的自定義選項,類似於管理PDF文件中的字體。 通過將UseGoogleFont設置為true來使用系統字體或Google字體。

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");

輸出PDF的樣子如何?

我如何建立多行文字加蓋?

<br>標籤。 例如,"line 1
line 2"在第一行生成"line 1",在第二行生成"line 2"。這樣即可建立地址加蓋或多行水印。


我如何在PDF上加蓋圖像?

建立一個ApplyStamp方法將圖像應用於文件。 該方法的第二個參數接受頁面索引以加蓋單頁或多頁。 以下範例在PDF的第1頁上加蓋圖像。

提示: 所有頁面索引均使用從零開始的索引。

對於複雜的圖像操作,探索將圖像新增到PDF或使用base64編碼的圖像

using IronPdf;
using IronPdf.Editing;
using System;

ChromePdfRenderer renderer = new ChromePdfRenderer();

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

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

// Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0);

pdf.SaveAs("stampImage.pdf");

圖像加蓋的輸出樣子如何?

支持哪些圖像格式?

ImageStamper支持PNG、JPEG、GIF和SVG通過URI引用或文件路徑。 確保遠程圖像的網路連接正常。 對於Azure環境,可以考慮使用來自Azure Blob Storage的圖像


我如何應用多個加蓋?

使用ApplyMultipleStamps通過傳遞一個加蓋器陣列來應用多個加蓋。 此方法在一個操作中有效處理多個加蓋。

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");

加蓋重疊時會發生什麼?

我可以混合不同型別的加蓋嗎?

BarcodeStamper。 同時建立具有頁眉、頁腳、水印和識別程式碼的複雜文件佈局。


我如何控制加蓋位置?

使用一個3x3的網格定義加蓋位置,具有三個水平列和三個垂直行。 選擇水平對齊方式:左,中心,右。 選擇垂直對齊方式:頂部,中間,底部。 調整水平和垂直偏移量以獲得精確的定位。 請參閱下面的圖像以獲得視覺表示。

IronPDF加蓋API對齊網格顯示水平/垂直定位選項和偏移範例

關鍵定位屬性是什麼?

  • HorizontalAlignment:相對於頁面的水平對齊。 預設值:HorizontalAlignment.Center
  • VerticalAlignment:相對於頁面的垂直對齊。 預設值:VerticalAlignment.Middle
  • HorizontalOffset:水平偏移。 預設值:0,單位:MeasurementUnit.Percentage。 正值向右偏移,負值向左偏移。
  • VerticalOffset:垂直偏移。 預設值:0,單位:MeasurementUnit.Percentage。 正值向下偏移,負值向上偏移。

我如何設置精確的偏移量?

使用VerticalOffset。 預設測量單位為百分比。 可用的單位包括英寸、毫米、厘米、像素和點。 這允許在PDF文件中進行精確定位,例如設置自定義邊距

程式碼

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),
};

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能,例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000,同時提高生產力,釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官,OPYN

查看案例研究

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones

首席軟體工程師,Agorus Build

查看案例研究

我如何加蓋HTML內容?

使用HtmlStamper類加蓋文字和圖像。 HtmlStamper使用CSS樣式渲染HTML設計,然後將其加蓋到PDF文件上。 HtmlBaseUrl屬性指定HTML字串資產的基本URL,如CSS和圖像文件。 這使用與將HTML轉換為PDF相同的渲染引擎。

程式碼

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加蓋器的基本屬性是什麼?

  • Html:要加蓋到PDF的HTML片段。 JavaScript、CSS及圖像的外部引用相對於HtmlBaseUrl
  • HtmlBaseUrl:外部CSS、JavaScript及圖像文件引用的基本URL。
  • CssMediaType:啟用Media="screen" CSS樣式。 設置AllowScreenCss=false使用媒介為"print"的CSS來渲染加蓋。 預設值:PdfCssMediaType.Screen

為什麼要使用HTML加蓋器而不是文字加蓋器?

HTMLStamper提供完整的HTML和CSS支持,用於複雜的佈局、多種字體、顏色和嵌入的圖像在一個加蓋中。適合用於豐富內容的水印或頁眉。 保持一致的品牌形象並支持響應式CSS設計


我如何加蓋條形碼?

BarcodeStamper類直接在現有的PDF文件上加蓋條形碼。 支持QRCode、Code128和Code39條形碼型別。

程式碼

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處理URLs和大資料集(最多4296個字母數字字元)。 Code128適合有高密度要求的字母數字資料。 Code39適用於簡單的數字或大寫字母組合。 在選擇條形碼型別時考慮掃描裝置的相容性。


有哪些其他加蓋選項?

這些屬性提供對加蓋外觀和行為的精細控制,類似於建立自定義水印

我如何控制加蓋外觀?

  • Opacity:控制透明度。 0是不可見,100是不透明。
  • Rotation:將加蓋順時針旋轉0到360度。
  • MaxWidth:輸出加蓋的最大寬度。
  • MaxHeight:輸出加蓋的最大高度。
  • MinWidth:輸出加蓋的最小寬度。
  • MinHeight:輸出加蓋的最小高度。
  • Hyperlink:為加蓋的元素新增單擊超連結。 注意:HTML連結(a標籤)無法通過加蓋保留。
  • Scale:對加蓋應用百分比縮放。 預設值:100(無效果)。
  • IsStampBehindContent:將加蓋置於內容後。 如果內容是不透明的,加蓋可能不可見。
  • WaitFor:等待事件或時間。參見使用WaitFor來延遲PDF渲染
  • Timeout:渲染超時以秒為單位。 預設值:60。

最常用的屬性有哪些?

IsStampBehindContent建立水印。 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
};

摘要

IronPDF的加蓋功能將文字、圖像、HTML內容和條形碼新增到現有的PDF文件。 四個專用的加蓋器類具有豐富的自定義選項,可以建立帶有水印、頁眉、頁腳和註釋的專業文件。 包含多種測量單位和對齊選項的定位系統確保每一像素都精確無誤。 使用簡單的文字加蓋或具有CSS樣式的複雜HTML佈局。 IronPDF的加蓋API為企業級PDF操作提供靈活性和控制力。

常見問題

如何在 C# 中將文字浮水印新增到我的 PDF 文件中?

using IronPDF 的 TextStamper 類別來新增文字浮水印。建立一個 TextStamper 物件,設置屬性,如文字、字體大小和透明度,然後使用 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擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...
閱讀更多

準備開始了嗎?

Nuget Downloads 20,667,543版本:2026.7剛剛發布

立即獲取免費

立即獲取 30天試用金鑰

bullet_checked無需信用卡或註冊帳號
bullet_test在生產
環境中進行測試,且不顯示浮水印
bullet_calendar30 天全
功能產品
bullet_support試用期間提供 24/5 技術
支援
立即獲取您的免費30天試用密鑰
不需要信用卡或建立賬戶
C# 用於PDF的NuGet程式庫
使用NuGet安裝

版本: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器,右鍵點選參考,管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝
C# PDF DLL
下載DLL

版本: 2026.7

立即下載

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置,位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器,右鍵點選參考。選擇瀏覽,"IronPdf.dll"

授權從$999

有問題嗎?聯絡我們的開發團隊。

Key in blue circle

立即免費取得 30 天試用金鑰

無任何限制。100% 解鎖。無需信用卡。

bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費現場演示
Booking Badge

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰
無需信用卡或帳戶建立