如何在 C# 中新增和編輯 PDF 註解

Updated: 2026年6月29日

IronPDF 讓 C# 開發者可以透過簡單的 API 呼叫（如 AddTextAnnotation）來新增、編輯和刪除 PDF 註解，包括文字評論和便籤，從而提高業務應用程式中文件協作和審查流程的效率。 X

您的企業在PDF安全和合規性方面的年度訂閱費用過高。不妨考慮IronSecureDoc ，它提供SaaS服務管理解決方案，例如數位簽章、內容編輯、加密和保護，所有服務只需一次性付費。了解IronSecureDoc文件

註解允許使用者在文件的特定部分新增註解、提醒或其他資訊。這些工具可在處理 PDF 時加強協作與溝通，讓使用者能夠註解、評論共用內容，並提供上下文。 Y

PDF 註解在業務工作流程中有各種用途：審閱人員可以在文件上標示反饋意見，團隊可以在不修改原始內容的情況下協同處理合約，品質保證團隊可以標示技術文件中的問題。無論您是在建立文件管理系統或強化現有的 PDF 工作流程，IronPDF 的註解功能都能與您的 C# PDF 創作和編輯功能無縫整合。對於需要先進安全功能以及註解功能的組織，請探索我們全面的 IronPDF 安全性教學。

快速入門：使用IronPDF向PDF新增註釋

本快速指南演示了如何在 C# 中使用 IronPDF 在 PDF 文件中新增文字注释。只需幾行程式碼，開發人員就能透過加入註解或備註來增強 PDF 的功能，增加文件的互動性與協作性。首先載入您的 PDF 文件，並使用 AddTextAnnotation 方法快速插入註解。

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

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

PdfDocument.FromFile("input.pdf")
    .Annotations.Add(new TextAnnotation(0) { Title="Note", Contents="Review this section.", X=50, Y=700 })
    .SaveAs("annotated.pdf");

PdfDocument.FromFile("input.pdf")
    .Annotations.Add(new TextAnnotation(0) { Title="Note", Contents="Review this section.", X=50, Y=700 })
    .SaveAs("annotated.pdf");

PdfDocument.FromFile("input.pdf") _
    .Annotations.Add(New TextAnnotation(0) With {.Title = "Note", .Contents = "Review this section.", .X = 50, .Y = 700}) _
    .SaveAs("annotated.pdf")

PdfDocument.FromFile("input.pdf") _
    .Annotations.Add(New TextAnnotation(0) With {.Title = "Note", .Contents = "Review this section.", .X = 50, .Y = 700}) _
    .SaveAs("annotated.pdf")

3部署以在您的實時環境中測試

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

最小工作流程（5 個步驟）

下載用於 PDF 註釋的 C# 庫
載入現有的或渲染新的 PDF 文件
使用 Add 方法新增註解
擷取與編輯 PDF 註解
從 PDF 文件移除註解

如何在 PDF 中加入註解？

Annotations Title Contents X Y

PDF 註解允許在 PDF 頁面上新增類似"便條"的註解。通過使用 Add 的方法，註解可以程式化地新增到 Annotations 屬性。

PDF 中的文字註解功能類似於實體文件中的便條貼。它們會以小圖示的形式出現在頁面上，點擊後會顯示完整的註解文字。這種非侵入式的方法可保持文件的可讀性，同時提供必要的回饋機制。在處理 HTML 至 PDF 的轉換時，您可以在轉換後加入註解，以標示需要檢閱的區域或提供額外的上下文。此功能與 JavaScript 渲染結合時，對於可能需要額外說明的動態內容尤其有用。

提示: 所有頁面索引都採用零為基準的索引。

using IronPdf;
using IronPdf.Annotations;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Annotation</h1>");

// Create a PDF annotation object on a specified page index
TextAnnotation annotation = new TextAnnotation(0)
{
    Title = "This is the title",
    Contents = "This is the long 'sticky note' comment content...",
    X = 50,
    Y = 700,
};

// Add the annotation
pdf.Annotations.Add(annotation);
pdf.SaveAs("annotation.pdf");

using IronPdf;
using IronPdf.Annotations;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Annotation</h1>");

// Create a PDF annotation object on a specified page index
TextAnnotation annotation = new TextAnnotation(0)
{
    Title = "This is the title",
    Contents = "This is the long 'sticky note' comment content...",
    X = 50,
    Y = 700,
};

// Add the annotation
pdf.Annotations.Add(annotation);
pdf.SaveAs("annotation.pdf");

Imports IronPdf
Imports IronPdf.Annotations

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Annotation</h1>")

' Create a PDF annotation object on a specified page index
Dim annotation As New TextAnnotation(0) With {
    .Title = "This is the title",
    .Contents = "This is the long 'sticky note' comment content...",
    .X = 50,
    .Y = 700
}

' Add the annotation
pdf.Annotations.Add(annotation)
pdf.SaveAs("annotation.pdf")

Imports IronPdf
Imports IronPdf.Annotations

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Annotation</h1>")

' Create a PDF annotation object on a specified page index
Dim annotation As New TextAnnotation(0) With {
    .Title = "This is the title",
    .Contents = "This is the long 'sticky note' comment content...",
    .X = 50,
    .Y = 700
}

' Add the annotation
pdf.Annotations.Add(annotation)
pdf.SaveAs("annotation.pdf")

TextAnnotation 類提供了多個自訂屬性：

Title：註解的標題文字，通常顯示於註解彈出視窗中
Contents：註解的主要正文文字
X, Y：指定註解圖示在頁面上出現位置的座標
PageIndex：註解應放置的頁面（以零為起始）的頁碼

對於更複雜的文件工作流程，可考慮將註解與其他 IronPDF 功能結合，例如用於核准流程的數位簽名，或用於文件版本管理的水印。在處理敏感文件時，您也可以將註解與 PDF 權限和密碼整合，以控制誰可以檢視或修改註解。

我可以為文字註解設定哪些屬性？

TextAnnotation 類提供了比基本屬性更多的自訂屬性：

Title：註解的標題文字，通常顯示於註解彈出視窗中
Contents：註解的主要正文文字
X, Y：指定註解圖示在頁面上出現位置的座標
PageIndex：註解應放置的頁面（以零為起始）的頁碼
Subject：用於分類註解的可選主題行
Icon：註解的視覺表示（例如：注釋、評論、幫助）
Open：註解彈出視窗是否預設開啟

這些特性可讓開發人員建立豐富的上下文註解，加強文件溝通。對於涉及多種文件型別的進階工作流程，可考慮探索 RTF 至 PDF 的轉換或 Markdown 至 PDF 的轉換，以跨不同來源格式維持註解。

PDF 註解中的座標如何運作？

PDF 座標從頁面左下角開始，與許多使用左上角起源的 UI 架構不同。 X 和 Y 屬性決定註解圖示在頁面上的出現位置，測量單位為點（1/72 英寸）。在以程式方式定位註解時，請確保您的座標計算考慮到此差異。

在計算註解的位置時，請記住標準的 US Letter 頁面是 8.5 x 11 英吋（612 x 792 點）。 A4 頁面尺寸為 595 x 842 點。若要精確定位，您可能需要在放置註解之前，以程式化的方式擷取頁面尺寸。在使用自訂紙張尺寸或根據內容實施回應式註釋位置時，這一點變得尤為重要。

帶註解的 PDF

上述 PDF 文件中的注解可使用 Chrome 瀏覽器檢視。

我該如何擷取和編輯現有的註解？

擷取和編輯 PDF 註解可提高清晰度、準確性和可用性，從而改善協作。通過 Annotations 屬性存取註解集合，並使用新資訊更新諸如 Y 等屬性。

在處理現有的 PDF（尤其是來自 URL 轉換或 DOCX 匯入的 PDF）時，您可能需要修改其他使用者或系統所新增的註解。 IronPDF 提供了對注釋集合的完整存取權，讓您可以透過程式化的方式遍歷、識別和更新特定的注釋。在實施文件審閱工作流程或與現有文件管理系統整合時，這項能力是不可或缺的。

using IronPdf;
using IronPdf.Annotations;
using System.Linq;

PdfDocument pdf = PdfDocument.FromFile("annotation.pdf");

// Retrieve annotation collection
PdfAnnotationCollection annotationCollection = pdf.Annotations;

// Select the first annotation
TextAnnotation annotation = (TextAnnotation)annotationCollection.First();

// Edit annotation
annotation.Title = "New title";
annotation.Contents = "New content...";
annotation.X = 150;
annotation.Y = 800;

pdf.SaveAs("editedAnnotation.pdf");

using IronPdf;
using IronPdf.Annotations;
using System.Linq;

PdfDocument pdf = PdfDocument.FromFile("annotation.pdf");

// Retrieve annotation collection
PdfAnnotationCollection annotationCollection = pdf.Annotations;

// Select the first annotation
TextAnnotation annotation = (TextAnnotation)annotationCollection.First();

// Edit annotation
annotation.Title = "New title";
annotation.Contents = "New content...";
annotation.X = 150;
annotation.Y = 800;

pdf.SaveAs("editedAnnotation.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports System.Linq

Private pdf As PdfDocument = PdfDocument.FromFile("annotation.pdf")

' Retrieve annotation collection
Private annotationCollection As PdfAnnotationCollection = pdf.Annotations

' Select the first annotation
Private annotation As TextAnnotation = CType(annotationCollection.First(), TextAnnotation)

' Edit annotation
annotation.Title = "New title"
annotation.Contents = "New content..."
annotation.X = 150
annotation.Y = 800

pdf.SaveAs("editedAnnotation.pdf")

Imports IronPdf
Imports IronPdf.Annotations
Imports System.Linq

Private pdf As PdfDocument = PdfDocument.FromFile("annotation.pdf")

' Retrieve annotation collection
Private annotationCollection As PdfAnnotationCollection = pdf.Annotations

' Select the first annotation
Private annotation As TextAnnotation = CType(annotationCollection.First(), TextAnnotation)

' Edit annotation
annotation.Title = "New title"
annotation.Contents = "New content..."
annotation.X = 150
annotation.Y = 800

pdf.SaveAs("editedAnnotation.pdf")

編輯程式會維護所有其他文件屬性與內容，確保僅修改指定的註解。這在審閱工作流程中特別有用，在此流程中，註解可能需要根據文件修訂或需求變化進行更新。若要進行全面的文件管理，可考慮將註解編輯與 metadata 操作結合，以追蹤文件版本和修訂歷史。

為什麼我需要編輯現有的註解？

在協同文件工作流程中，編輯註解變得非常重要，因為在此流程中，回饋需要根據修訂內容進行更新，模棱兩可的註解需要澄清，或者註解因內容變更而需要重新定位。此能力可確保文件審閱在整個修訂週期中保持最新和相關。

在企業環境中，註解編輯通常會與核准工作流程整合，主管可能需要在最終核准前修改審核員的意見。此外，當文件進行翻譯或本地化時，可能需要更新註解以反映語言變更或文化適應。針對這種情況，IronPDF 的 UTF-8 和國際語言支援可確保注釋在不同的語言和字元集中正確顯示。

編輯註解時，其他文件屬性會發生什麼變化？

編輯程式會維護所有其他文件屬性與內容，確保僅修改指定的註解。文件結構、格式、內嵌資源和其他註解保持不變，在保持 PDF 完整性的同時，允許針對特定的審查意見進行有針對性的更新。

這種選擇性的編輯方式對於保持文件的完整性至關重要，尤其是在必須避免文件被篡改的管制行業。此過程會保留數位簽章、表格欄位、書籤以及所有其他 PDF 功能。對於需要稽核追蹤的文件，可考慮在進行註解修改的同時，實施修訂歷程追蹤。

附有編輯註釋的 PDF 文件

上述 PDF 文件中的注解可使用 Chrome 瀏覽器檢視。

如何從 PDF 文件中移除註解？

使用以下方法移除不必要或過時的註解：RemoveAllAnnotationsForPage 和 Clear。

RemoveAt：移除指定索引的單個註解。
RemoveAllAnnotationsForPage：移除指定頁面上的所有註解。
Clear：移除整個文件中的所有註解。

註解的移除對於文件的定稿至關重要。在吸收反饋意見並進行必要的修改後，您可能需要在分發最終版本之前清理審閱意見。此流程與其他 IronPDF 功能 (例如 PDF 壓縮) 整合良好，可建立乾淨、最佳化的文件以供分發。對於需要歸檔的文件，請考慮在移除註解後轉換為 IronPDF/A 格式，以確保長期保存的合規性。

如何移除單一註解？

要移除單個註解，請使用 RemoveAt 方法，並基於註解集合索引提供對應的索引。

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1);

pdf.SaveAs("removeSingleAnnotation.pdf");

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1);

pdf.SaveAs("removeSingleAnnotation.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1)

pdf.SaveAs("removeSingleAnnotation.pdf")

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1)

pdf.SaveAs("removeSingleAnnotation.pdf")

以程式方式移除註解時，必須瞭解每次移除註解後，註解集合都會重新編排索引。如果您需要移除多個特定的註解，請在集合中倒序進行，或先收集要移除的註解，然後再倒序移除。此方法可避免索引移位問題，以免移除錯誤的註解。

移除 PDF 上的單一註解

前

後

上述 PDF 文件中的注解可使用 Chrome 瀏覽器檢視。

如何一次移除所有註解？

要移除特定頁面上的所有註解，請使用 RemoveAllAnnotationsForPage 方法並指定頁面索引。如果您想要移除整個文件中的所有註解，請在 Annotations 屬性上調用 Clear 方法。

在準備最終發佈的文件或實施文件版本系統時，需要移除先前審核週期的註解，此大量移除功能特別有用。考慮結合 metadata 編輯，以更新文件屬性並顯示審閱狀態。對於需要淨化文件的工作流程，探索文件淨化選項，以刪除所有可能敏感的資訊，包括註釋。

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0);

// Remove all annotaions on the document
pdf.Annotations.Clear();

pdf.SaveAs("removeAllAnnotation.pdf");

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0);

// Remove all annotaions on the document
pdf.Annotations.Clear();

pdf.SaveAs("removeAllAnnotation.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0)

' Remove all annotaions on the document
pdf.Annotations.Clear()

pdf.SaveAs("removeAllAnnotation.pdf")

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0)

' Remove all annotaions on the document
pdf.Annotations.Clear()

pdf.SaveAs("removeAllAnnotation.pdf")

何時應該使用大量註解移除？

批量刪除是完成文件分發、建立乾淨版本存檔或實施文件版本化（必須清除先前審核週期的註解）時的理想選擇。與個別移除註解相比，此方法可節省時間，並確保生產文件中不會意外留下審核註解。

此外，在為可能無法正確處理註解的自動處理系統準備文件，或將註解的 PDF 轉換為其他格式時，批量移除是必要的。對於高度安全的環境，在分發前移除所有註解可防止內部審查意見或敏感回饋不慎外洩，而這些意見或回饋並非為外部受眾而設。

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

Milan Jovanovic

Microsoft MVP

查看案例研究

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

Brent Matzelle

首席技術官，OPYN

查看案例研究

如何在PDF中新增可點擊的內部連結？

LinkAnnotation DestinationType Hidden

LinkAnnotation 類在頁面上建立一個可點擊的矩形，當點擊時會導航到同一個 PDF 中的另一頁。它非常適合用於建立自訂的目錄、交叉引用、"返回頂部"按鈕和其他文件內導航。與 TextAnnotation 類似，LinkAnnotation 通過 Annotations.Add 方法新增，所以它整合到您已使用於評論和便箋的集合中。

位置由 Width 和 Height 設定（以點為單位，72 點=1 英寸），或者直接分配 Rectangle。連結所在的頁面和目標頁面都用零基索引在構造函式中指定。

提示: Width 和 Height 在您設置它們之前全部返回 -1。忘記設置它們會產生無效的註釋，因此始終分配可點擊區域。

using IronPdf;
using IronPdf.Annotations;

// Load an existing multi-page PDF
PdfDocument pdf = PdfDocument.FromFile("multipage.pdf");

// Create a clickable link on page 1 (index 0) that jumps to page 6 (index 5).
// Page indexes are zero-based. The default DestinationType (Page) fits the
// whole destination page in the viewer when the link is clicked.
LinkAnnotation link = new LinkAnnotation(pageIndex: 0, destinationPageIndex: 5)
{
    X = 72,        // points from the LEFT edge of the page (72 points = 1 inch)
    Y = 700,       // BOTTOM edge of the clickable area (PDF origin is bottom-left)
    Width = 200,
    Height = 20,
    Contents = "Go to Chapter 6"
};

// LinkAnnotation lives in the same collection as TextAnnotation
pdf.Annotations.Add(link);
pdf.SaveAs("internal-link.pdf");

using IronPdf;
using IronPdf.Annotations;

// Load an existing multi-page PDF
PdfDocument pdf = PdfDocument.FromFile("multipage.pdf");

// Create a clickable link on page 1 (index 0) that jumps to page 6 (index 5).
// Page indexes are zero-based. The default DestinationType (Page) fits the
// whole destination page in the viewer when the link is clicked.
LinkAnnotation link = new LinkAnnotation(pageIndex: 0, destinationPageIndex: 5)
{
    X = 72,        // points from the LEFT edge of the page (72 points = 1 inch)
    Y = 700,       // BOTTOM edge of the clickable area (PDF origin is bottom-left)
    Width = 200,
    Height = 20,
    Contents = "Go to Chapter 6"
};

// LinkAnnotation lives in the same collection as TextAnnotation
pdf.Annotations.Add(link);
pdf.SaveAs("internal-link.pdf");

Imports IronPdf
Imports IronPdf.Annotations

' Load an existing multi-page PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("multipage.pdf")

' Create a clickable link on page 1 (index 0) that jumps to page 6 (index 5).
' Page indexes are zero-based. The default DestinationType (Page) fits the
' whole destination page in the viewer when the link is clicked.
Dim link As New LinkAnnotation(pageIndex:=0, destinationPageIndex:=5) With {
    .X = 72,        ' points from the LEFT edge of the page (72 points = 1 inch)
    .Y = 700,       ' BOTTOM edge of the clickable area (PDF origin is bottom-left)
    .Width = 200,
    .Height = 20,
    .Contents = "Go to Chapter 6"
}

' LinkAnnotation lives in the same collection as TextAnnotation
pdf.Annotations.Add(link)
pdf.SaveAs("internal-link.pdf")

Imports IronPdf
Imports IronPdf.Annotations

' Load an existing multi-page PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("multipage.pdf")

' Create a clickable link on page 1 (index 0) that jumps to page 6 (index 5).
' Page indexes are zero-based. The default DestinationType (Page) fits the
' whole destination page in the viewer when the link is clicked.
Dim link As New LinkAnnotation(pageIndex:=0, destinationPageIndex:=5) With {
    .X = 72,        ' points from the LEFT edge of the page (72 points = 1 inch)
    .Y = 700,       ' BOTTOM edge of the clickable area (PDF origin is bottom-left)
    .Width = 200,
    .Height = 20,
    .Contents = "Go to Chapter 6"
}

' LinkAnnotation lives in the same collection as TextAnnotation
pdf.Annotations.Add(link)
pdf.SaveAs("internal-link.pdf")

除了位置設置，還有一些屬性控制外觀和元資料：Color 設置連結的邊框顏色，Contents 提供描述性文字或工具提示，Title 命名註解。對於現有內容的不顯示點擊覆蓋，將 Color 保持不設置並設置 Hidden = true（本指南稍後會展示）。

連結註釋和文字註釋之間有什麼區別？

一個 TextAnnotation 是一個"便箋"：一個在點擊時顯示文字的評論圖示。一個 LinkAnnotation 是一個導航控制，無形或有邊框的可點擊區域，可使讀者跳轉到目標頁面。這兩者共用 Annotations 集合和相同的 RemoveAllAnnotationsForPage 和 Clear 操作，因此您可以在同一文件中混合使用評論和導航連結並進行管理。

因為 LinkAnnotation 目標是同一文件中的頁面，所以它補充了 IronPDF 的大綱和書籤（建立查看器的側邊欄導航樹）以及自動生成的目錄功能，用於 HTML 到 PDF 的渲染。當您需要在現有的 PDF 上新增可點擊的熱點時，請使用書籤功能用於側邊欄，用於渲染 HTML 的目錄功能，和 LinkAnnotation。

如何控制讀者在目的地看到的內容？

DestinationType 屬性使用現有的 BookmarkDestinations 枚舉來控制當點擊連結時目標頁面如何顯示。預設是 BookmarkDestinations.Page，整個目的地頁面能適合視窗。其他值會捲動到一個位置，設定縮放級別，或適合特定矩形，使用 DestinationBottom 和 DestinationZoom 座標。

`BookmarkDestinations` 值	點擊時的行為	使用的目的地座標
`Page`（預設）	將目的地頁面整個適合顯示在視窗中。	none
`PageY`	滾動到垂直位置; 顯示全寬度。	`DestinationTop`
`PageX`	滾動到水平位置; 顯示全高度。	`DestinationLeft`
`PageZoom`	移動到一個位置並設置一個縮放級別。	`DestinationLeft`, `DestinationTop`, `DestinationZoom`
`PageRect`	將特定矩形適合顯示在頁面上。	`DestinationLeft`, `DestinationBottom`, `DestinationRight`, `DestinationTop`
`PageBounds`	根據其邊界框適合頁面。	none
`PageBoundsY`	與 `PageY` 相同，基於頁面的邊界框。	`DestinationTop`
`PageBoundsX`	與 `PageX` 相同，基於頁面的邊界框。	`DestinationLeft`

提示: DestinationZoom = 0的意思是"繼承當前的縮放"，而不是零縮放。設定一個值，如 150 為 150%。

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;

PdfDocument pdf = PdfDocument.FromFile("multipage.pdf");

// 1. Scroll to a specific vertical position on the destination page (full width shown)
LinkAnnotation scrollLink = new LinkAnnotation(0, 2)
{
    X = 72, Y = 680, Width = 300, Height = 16,
    DestinationType = BookmarkDestinations.PageY,
    DestinationTop = 400        // scroll so y=400 sits at the top of the view
};
pdf.Annotations.Add(scrollLink);

// 2. Jump to a position AND set the zoom level
LinkAnnotation zoomLink = new LinkAnnotation(0, 3, "Zoom to figure")
{
    X = 72, Y = 650, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageZoom,
    DestinationLeft = 100,
    DestinationTop = 500,
    DestinationZoom = 150       // 150% zoom; use 0 to inherit the current zoom
};
pdf.Annotations.Add(zoomLink);

// 3. Fit a specific rectangle on the destination page
LinkAnnotation rectLink = new LinkAnnotation(0, 4)
{
    X = 72, Y = 620, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageRect,
    DestinationLeft = 50,
    DestinationBottom = 100,
    DestinationRight = 550,
    DestinationTop = 700
};
pdf.Annotations.Add(rectLink);

pdf.SaveAs("link-destinations.pdf");

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;

PdfDocument pdf = PdfDocument.FromFile("multipage.pdf");

// 1. Scroll to a specific vertical position on the destination page (full width shown)
LinkAnnotation scrollLink = new LinkAnnotation(0, 2)
{
    X = 72, Y = 680, Width = 300, Height = 16,
    DestinationType = BookmarkDestinations.PageY,
    DestinationTop = 400        // scroll so y=400 sits at the top of the view
};
pdf.Annotations.Add(scrollLink);

// 2. Jump to a position AND set the zoom level
LinkAnnotation zoomLink = new LinkAnnotation(0, 3, "Zoom to figure")
{
    X = 72, Y = 650, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageZoom,
    DestinationLeft = 100,
    DestinationTop = 500,
    DestinationZoom = 150       // 150% zoom; use 0 to inherit the current zoom
};
pdf.Annotations.Add(zoomLink);

// 3. Fit a specific rectangle on the destination page
LinkAnnotation rectLink = new LinkAnnotation(0, 4)
{
    X = 72, Y = 620, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageRect,
    DestinationLeft = 50,
    DestinationBottom = 100,
    DestinationRight = 550,
    DestinationTop = 700
};
pdf.Annotations.Add(rectLink);

pdf.SaveAs("link-destinations.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks

Dim pdf As PdfDocument = PdfDocument.FromFile("multipage.pdf")

' 1. Scroll to a specific vertical position on the destination page (full width shown)
Dim scrollLink As New LinkAnnotation(0, 2) With {
    .X = 72,
    .Y = 680,
    .Width = 300,
    .Height = 16,
    .DestinationType = BookmarkDestinations.PageY,
    .DestinationTop = 400 ' scroll so y=400 sits at the top of the view
}
pdf.Annotations.Add(scrollLink)

' 2. Jump to a position AND set the zoom level
Dim zoomLink As New LinkAnnotation(0, 3, "Zoom to figure") With {
    .X = 72,
    .Y = 650,
    .Width = 200,
    .Height = 16,
    .DestinationType = BookmarkDestinations.PageZoom,
    .DestinationLeft = 100,
    .DestinationTop = 500,
    .DestinationZoom = 150 ' 150% zoom; use 0 to inherit the current zoom
}
pdf.Annotations.Add(zoomLink)

' 3. Fit a specific rectangle on the destination page
Dim rectLink As New LinkAnnotation(0, 4) With {
    .X = 72,
    .Y = 620,
    .Width = 200,
    .Height = 16,
    .DestinationType = BookmarkDestinations.PageRect,
    .DestinationLeft = 50,
    .DestinationBottom = 100,
    .DestinationRight = 550,
    .DestinationTop = 700
}
pdf.Annotations.Add(rectLink)

pdf.SaveAs("link-destinations.pdf")

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks

Dim pdf As PdfDocument = PdfDocument.FromFile("multipage.pdf")

' 1. Scroll to a specific vertical position on the destination page (full width shown)
Dim scrollLink As New LinkAnnotation(0, 2) With {
    .X = 72,
    .Y = 680,
    .Width = 300,
    .Height = 16,
    .DestinationType = BookmarkDestinations.PageY,
    .DestinationTop = 400 ' scroll so y=400 sits at the top of the view
}
pdf.Annotations.Add(scrollLink)

' 2. Jump to a position AND set the zoom level
Dim zoomLink As New LinkAnnotation(0, 3, "Zoom to figure") With {
    .X = 72,
    .Y = 650,
    .Width = 200,
    .Height = 16,
    .DestinationType = BookmarkDestinations.PageZoom,
    .DestinationLeft = 100,
    .DestinationTop = 500,
    .DestinationZoom = 150 ' 150% zoom; use 0 to inherit the current zoom
}
pdf.Annotations.Add(zoomLink)

' 3. Fit a specific rectangle on the destination page
Dim rectLink As New LinkAnnotation(0, 4) With {
    .X = 72,
    .Y = 620,
    .Width = 200,
    .Height = 16,
    .DestinationType = BookmarkDestinations.PageRect,
    .DestinationLeft = 50,
    .DestinationBottom = 100,
    .DestinationRight = 550,
    .DestinationTop = 700
}
pdf.Annotations.Add(rectLink)

pdf.SaveAs("link-destinations.pdf")

如何把連結放在現有文字上？

要在已有的頁面文字上疊加一個可點擊的連結，請使用 PdfPage.TextChunks 擷取文字，並使用每部分的 BoundingBox 來設定連結的大小。由於 PDF 座標起始於頁面的左下角，將 BoundingBox.Bottom 分配給 Y，而不是 BoundingBox.Top，這將可點擊區域放置於可見文字的上方。設定 Hidden = true 來取消可見的邊框，使連結隱藏在已渲染的文字之上。

這是將靜態的、已列印的目錄變為可導航目錄的基礎。下面的範例掃描目錄頁，根據其文字匹配每個條目，並疊加一個跳轉到正確頁面的不可見 LinkAnnotation。

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;
using System;
using System.Collections.Generic;

PdfDocument pdf = PdfDocument.FromFile("report-with-toc.pdf");

// Zero-based index of the page that holds the table-of-contents text
int tocPageIndex = 1;

// Map each TOC entry's leading text to the page index it should jump to
var tocEntries = new Dictionary<string, int>
{
    { "Introduction", 2 },
    { "Methodology",  4 },
    { "Results",      6 },
    { "Conclusion",   9 },
};

// Walk the text chunks on the TOC page and overlay a clickable link on each match
foreach (var chunk in pdf.Pages[tocPageIndex].TextChunks)
{
    string text = chunk.Contents.Trim();

    foreach (var entry in tocEntries)
    {
        if (!text.StartsWith(entry.Key)) continue;

        var box = chunk.BoundingBox;
        pdf.Annotations.Add(new LinkAnnotation(tocPageIndex, entry.Value)
        {
            X = (int)box.Left,
            Y = (int)box.Bottom,                       // Bottom, NOT Top (PDF origin is bottom-left)
            Width = (int)Math.Max(box.Width, 400),
            Height = (int)Math.Abs(box.Top - box.Bottom),
            DestinationType = BookmarkDestinations.PageY,
            DestinationTop = 792,                      // top of a US Letter page
            Hidden = true                              // invisible overlay on the existing TOC text
        });
        break;
    }
}

pdf.SaveAs("clickable-toc.pdf");

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;
using System;
using System.Collections.Generic;

PdfDocument pdf = PdfDocument.FromFile("report-with-toc.pdf");

// Zero-based index of the page that holds the table-of-contents text
int tocPageIndex = 1;

// Map each TOC entry's leading text to the page index it should jump to
var tocEntries = new Dictionary<string, int>
{
    { "Introduction", 2 },
    { "Methodology",  4 },
    { "Results",      6 },
    { "Conclusion",   9 },
};

// Walk the text chunks on the TOC page and overlay a clickable link on each match
foreach (var chunk in pdf.Pages[tocPageIndex].TextChunks)
{
    string text = chunk.Contents.Trim();

    foreach (var entry in tocEntries)
    {
        if (!text.StartsWith(entry.Key)) continue;

        var box = chunk.BoundingBox;
        pdf.Annotations.Add(new LinkAnnotation(tocPageIndex, entry.Value)
        {
            X = (int)box.Left,
            Y = (int)box.Bottom,                       // Bottom, NOT Top (PDF origin is bottom-left)
            Width = (int)Math.Max(box.Width, 400),
            Height = (int)Math.Abs(box.Top - box.Bottom),
            DestinationType = BookmarkDestinations.PageY,
            DestinationTop = 792,                      // top of a US Letter page
            Hidden = true                              // invisible overlay on the existing TOC text
        });
        break;
    }
}

pdf.SaveAs("clickable-toc.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks
Imports System
Imports System.Collections.Generic

Dim pdf As PdfDocument = PdfDocument.FromFile("report-with-toc.pdf")

' Zero-based index of the page that holds the table-of-contents text
Dim tocPageIndex As Integer = 1

' Map each TOC entry's leading text to the page index it should jump to
Dim tocEntries As New Dictionary(Of String, Integer) From {
    {"Introduction", 2},
    {"Methodology", 4},
    {"Results", 6},
    {"Conclusion", 9}
}

' Walk the text chunks on the TOC page and overlay a clickable link on each match
For Each chunk In pdf.Pages(tocPageIndex).TextChunks
    Dim text As String = chunk.Contents.Trim()

    For Each entry In tocEntries
        If Not text.StartsWith(entry.Key) Then Continue For

        Dim box = chunk.BoundingBox
        pdf.Annotations.Add(New LinkAnnotation(tocPageIndex, entry.Value) With {
            .X = CInt(box.Left),
            .Y = CInt(box.Bottom),                      ' Bottom, NOT Top (PDF origin is bottom-left)
            .Width = CInt(Math.Max(box.Width, 400)),
            .Height = CInt(Math.Abs(box.Top - box.Bottom)),
            .DestinationType = BookmarkDestinations.PageY,
            .DestinationTop = 792,                      ' top of a US Letter page
            .Hidden = True                              ' invisible overlay on the existing TOC text
        })
        Exit For
    Next
Next

pdf.SaveAs("clickable-toc.pdf")

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks
Imports System
Imports System.Collections.Generic

Dim pdf As PdfDocument = PdfDocument.FromFile("report-with-toc.pdf")

' Zero-based index of the page that holds the table-of-contents text
Dim tocPageIndex As Integer = 1

' Map each TOC entry's leading text to the page index it should jump to
Dim tocEntries As New Dictionary(Of String, Integer) From {
    {"Introduction", 2},
    {"Methodology", 4},
    {"Results", 6},
    {"Conclusion", 9}
}

' Walk the text chunks on the TOC page and overlay a clickable link on each match
For Each chunk In pdf.Pages(tocPageIndex).TextChunks
    Dim text As String = chunk.Contents.Trim()

    For Each entry In tocEntries
        If Not text.StartsWith(entry.Key) Then Continue For

        Dim box = chunk.BoundingBox
        pdf.Annotations.Add(New LinkAnnotation(tocPageIndex, entry.Value) With {
            .X = CInt(box.Left),
            .Y = CInt(box.Bottom),                      ' Bottom, NOT Top (PDF origin is bottom-left)
            .Width = CInt(Math.Max(box.Width, 400)),
            .Height = CInt(Math.Abs(box.Top - box.Bottom)),
            .DestinationType = BookmarkDestinations.PageY,
            .DestinationTop = 792,                      ' top of a US Letter page
            .Hidden = True                              ' invisible overlay on the existing TOC text
        })
        Exit For
    Next
Next

pdf.SaveAs("clickable-toc.pdf")

我可以建立"返回頂部"或同頁面的連結嗎？

是的。同頁連結，即 pageIndex 等於 destinationPageIndex，完全支持，並且是建立"返回頂部"按鈕的典型方式。結合同頁連結與 DestinationType = BookmarkDestinations.PageY 和高 DestinationTop 值，使得點擊讓讀者捲動到當前頁面的頂部。在每一頁的頁腳新增相同的連結，讓長報告具備一致的返回頂部控制。

使用 PDF 註解的最佳作法是什麼？

在您的應用程式中實作註解功能時，請考慮這些最佳實務：

1.座標系統：PDF 座標從頁面的左下角開始，不像許多 UI 框架使用左上角為起始點。確保您的座標計算考慮到這種差異。

2.效能最佳化：新增多個註解時，請考慮批次操作，而不是每次新增後都儲存。此方法可改善效能，尤其是在處理大型 PDF 檔案時。

3.註解的可見性：並非所有的 PDF 檢視器都會以相同的方式顯示註解。在不同的檢視器中測試您附加註解的 PDF，以確保一致的使用者體驗。

4.與表單整合：註解是 IronPDF 表單的補充，可在不修改表單結構的情況下提供上下文說明或指示。

5.安全考量：在處理敏感文件時，請記住註解可能包含機密資訊。實施適當的安全措施，以保護註解內容。

6.可及性：考慮加入註解以增強文件的可讀性，為殘障使用者提供額外的上下文。這符合可存取文件的 IronPDF/UA 規範要求。

為什麼座標系統對於注解很重要？

源自左下角的 PDF 座標可能會讓習慣左上角原點系統的開發人員感到困惑。不正確的座標計算可能會將註解放置在意想不到的位置，可能會遮蔽重要內容或出現在頁面外。與 UI 框架或使用者輸入系統整合時，務必適當轉換座標。

在實施點擊註釋功能等功能或將使用者互動的螢幕坐標轉換為 PDF 坐標時，瞭解坐標系統變得更加重要。對於複雜的定位需求，請考慮使用 IronPDF 的 viewport 和 zoom 功能，以確保無論在任何檢視條件下，註解都能正確顯示。

在新增多個註解時，我該如何優化效能？

新增多個註解時，請先將所有註解新增至集合，然後再儲存文件，以進行批次作業。此方法可減少檔案 I/O 作業，並大幅提升效能，尤其是在處理大型 PDF 或連續處理多個文件時。考慮實施進度指標，以便在大量作業期間提供更好的使用者體驗。

// Example of batch annotation processing
var annotations = new List<TextAnnotation>();
for (int i = 0; i < 100; i++)
{
    annotations.Add(new TextAnnotation(0) 
    { 
        Title = $"Note {i}", 
        Contents = $"Content for note {i}",
        X = 50 + (i * 10),
        Y = 700 - (i * 20)
    });
}

// Add all annotations at once
foreach (var annotation in annotations)
{
    pdf.Annotations.Add(annotation);
}

// Save once after all additions
pdf.SaveAs("batch-annotated.pdf");

// Example of batch annotation processing
var annotations = new List<TextAnnotation>();
for (int i = 0; i < 100; i++)
{
    annotations.Add(new TextAnnotation(0) 
    { 
        Title = $"Note {i}", 
        Contents = $"Content for note {i}",
        X = 50 + (i * 10),
        Y = 700 - (i * 20)
    });
}

// Add all annotations at once
foreach (var annotation in annotations)
{
    pdf.Annotations.Add(annotation);
}

// Save once after all additions
pdf.SaveAs("batch-annotated.pdf");

Imports System.Collections.Generic

' Example of batch annotation processing
Dim annotations As New List(Of TextAnnotation)()
For i As Integer = 0 To 99
    annotations.Add(New TextAnnotation(0) With {
        .Title = $"Note {i}",
        .Contents = $"Content for note {i}",
        .X = 50 + (i * 10),
        .Y = 700 - (i * 20)
    })
Next

' Add all annotations at once
For Each annotation In annotations
    pdf.Annotations.Add(annotation)
Next

' Save once after all additions
pdf.SaveAs("batch-annotated.pdf")

Imports System.Collections.Generic

' Example of batch annotation processing
Dim annotations As New List(Of TextAnnotation)()
For i As Integer = 0 To 99
    annotations.Add(New TextAnnotation(0) With {
        .Title = $"Note {i}",
        .Contents = $"Content for note {i}",
        .X = 50 + (i * 10),
        .Y = 700 - (i * 20)
    })
Next

' Add all annotations at once
For Each annotation In annotations
    pdf.Annotations.Add(annotation)
Next

' Save once after all additions
pdf.SaveAs("batch-annotated.pdf")

若要在大量使用的情況下獲得更好的效能，請考慮使用異步處理或多執行緒技術並行處理註解作業。

跨檢視器相容性應該考慮哪些因素？

不同的 PDF 檢視器可能會以不同的圖示樣式、彈出行為或定位怪癖來呈現註解。務必在常用的檢視器（如 Adobe Acrobat、Chrome、Edge 和行動 PDF 閱讀器）中測試您註解的 PDF，以確保您的使用者在不同的平台上都能正確顯示註解並保持其功能。

某些檢視器可能不支援所有註解型別，或以不同方式顯示。為了達到最大的相容性，請堅持使用標準註解型別，並避免依賴檢視器特定的功能。部署到特定環境（例如 Azure 或 AWS ）時，請在目標環境的預設 PDF 檢視器中測試註解，以確保行為一致。

準備好看看您還能做些什麼嗎？在此查看我們的教學頁面：編輯 PDFs

常見問題

如何在C#中向PDF文件新增文字註解？

IronPDF提供簡單的API來使用AddTextAnnotation方法新增文字註解。您可以通過指定頁碼、位置坐標（X, Y）、標題和內容來建立註解。例如，您可以只用一行程式碼通過Annotations.Add方法和TextAnnotation物件新增便利貼註釋。

支持哪些型別的PDF註解？

IronPDF支持在PDF文件中像便利貼一樣的文字註解。這些註解作為頁面上的小圖標出現，點擊時顯示完整的評論文字，提供了一種非侵入性的方法來向文件的特定部分新增評論、提醒或附加資訊。

我可以以程式方式編輯現有的PDF註解嗎？

是的，IronPDF允許您通過API檢索和編輯現有的PDF註解。您可以使用PdfDocument物件的Annotations屬性存取註解，修改其屬性如標題、內容和位置，然後保存更改回PDF中。

如何從PDF文件中移除註解？

IronPDF提供方法以程式方式從PDF文件中移除註解。您可以存取PdfDocument的Annotations集合，然後移除特定註解或清除頁面或整個文件中的所有註解。

PDF註解的常見商業使用案例是什麼？

IronPDF的註解功能理想用於文件審閱工作流程，審閱者可以通過提供反饋標記文件、在不修改原始內容的情況下進行合同的團隊協作，質量保證隊伍標記技術文件中的問題。這些功能與文件管理系統無縫整合。

我需要安裝額外的軟體來使用PDF註解功能嗎？

不，IronPDF是一個自包含的C#程式庫，包括所有PDF註解功能。只需下載並在您的項目中引用IronPDF程式庫即可開始向PDF文件新增、編輯和移除註解，不需要任何外部依賴。

如何在C#中新增可點擊的內部導航連結到PDF？

使用IronPDF的LinkAnnotation類，通過與文字註解相同的Annotations.Add方法來新增。建立具有從零開始的頁面索引和目的地頁面索引的LinkAnnotation，使用X, Y, Width和Height（以點為單位）設置可點擊區域，IronPDF生成一個可跳轉到目標頁面的可點擊區域。這對於自定義目錄、交叉引用和返回頂部按鈕非常理想。

如何控制PDF連結被點擊時的縮放和滾動位置？

使用BookmarkDestinations枚舉設置LinkAnnotation的DestinationType屬性。預設的Page值適合整個目的地頁面，而PageY會滾動到垂直位置，PageZoom設置位置和縮放級別，PageRect適合特定的矩形。用DestinationTop, DestinationLeft, DestinationRight, DestinationBottom和DestinationZoom精細化視圖。注意，DestinationZoom = 0表示繼承當前縮放而非零縮放。

Why is it important to test PDFs with annotations across different readers?

Different PDF readers render annotations differently, affecting icon styles and popup behaviors. Testing in popular viewers like Adobe Acrobat, Chrome, and mobile readers ensures consistent appearance and functionality across platforms.

What are best practices for working with PDF annotations using IronPDF?

Best practices include understanding the coordinate system starting from the bottom-left, optimizing performance by batching annotation additions, ensuring cross-viewer compatibility, and considering security measures for annotated content.

Curtis Chau

立即與工程團隊聊天

技術作家

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

...

準備開始了嗎？

Nuget Downloads 21,253,952|版本：2026.10剛剛發布

使用NuGet安裝

版本： 2026.10

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

在解決方案資源管理器，右鍵點選參考，管理NuGet包
選擇瀏覽並搜尋"IronPdf"
選擇套件並安裝

下載DLL

版本： 2026.10

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

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

授權從$999起

開始免費30天試用

如何在 C# 中新增和編輯 PDF 註解

1Install IronPDF with NuGet Package Manager

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

3部署以在您的實時環境中測試

最小工作流程（5 個步驟）

如何在 PDF 中加入註解？

我可以為文字註解設定哪些屬性？

PDF 註解中的座標如何運作？

帶註解的 PDF

我該如何擷取和編輯現有的註解？

為什麼我需要編輯現有的註解？

編輯註解時，其他文件屬性會發生什麼變化？

附有編輯註釋的 PDF 文件

如何從 PDF 文件中移除註解？

如何移除單一註解？

移除 PDF 上的單一註解

如何一次移除所有註解？

何時應該使用大量註解移除？

Milan Jovanovic

Brent Matzelle

如何在PDF中新增可點擊的內部連結？

連結註釋和文字註釋之間有什麼區別？

如何控制讀者在目的地看到的內容？

如何把連結放在現有文字上？

我可以建立"返回頂部"或同頁面的連結嗎？

使用 PDF 註解的最佳作法是什麼？

為什麼座標系統對於注解很重要？

在新增多個註解時，我該如何優化效能？

跨檢視器相容性應該考慮哪些因素？

常見問題

如何在C#中向PDF文件新增文字註解？

支持哪些型別的PDF註解？

我可以以程式方式編輯現有的PDF註解嗎？

如何從PDF文件中移除註解？

PDF註解的常見商業使用案例是什麼？

我需要安裝額外的軟體來使用PDF註解功能嗎？

如何在C#中新增可點擊的內部導航連結到PDF？

如何控制PDF連結被點擊時的縮放和滾動位置？

Why is it important to test PDFs with annotations across different readers?

What are best practices for working with PDF annotations using IronPDF?

產品連結