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提供四個加蓋器:BarcodeStamper。 HTMLStamper利用所有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 一次性在多個頁面上加蓋。

How can I create a semi-transparent watermark with IronPDF?

You can create a semi-transparent watermark using the `Opacity` property in the stamper classes of IronPDF. For example, set `Opacity` to 25 to apply a lightly transparent watermark on the PDF document.

What barcode types can I stamp on PDFs using IronPDF?

IronPDF's `BarcodeStamper` class supports QRCode, Code128, and Code39 barcode types. Each type is suitable for different encoding requirements and can be customized for size and positioning.

Is it possible to add hyperlinks to stamped elements in IronPDF?

Yes, IronPDF allows you to add hyperlinks to stamped elements through the `Hyperlink` property. However, note that HTML links (a tags) aren't preserved by stamping.

Can I use Google Fonts when stamping text on a PDF document?

Yes, IronPDF allows you to use Google Fonts with the `TextStamper`. Set the `UseGoogleFont` property to true and specify the desired font family to use Google Fonts in your text stamps.

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...
閱讀更多

準備開始了嗎?

Nuget Downloads 21,105,021版本:2026.9剛剛發布

立即獲取免費

立即獲取 30天試用金鑰。

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

版本: 2026.9

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

版本: 2026.9

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

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

授權從$999起

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

Key in blue circle

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

Your trial license will be sent to your email address

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

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

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

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

版本: 2026.9

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

版本: 2026.9

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

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

授權從$999起