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

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

TextAnnotation 類別除了基本屬性外，還提供數個用於自訂的屬性：

• Title：註解的標題文字，通常顯示於註解彈出視窗中
• Contents：註解的主體文字
• X, Y：指定註解圖示在頁面中顯示位置的座標
• PageIndex：註解應放置的零起始頁碼
• Subject：用於分類註解的可選主旨行
• Icon：註解（例如：註記、評論、說明）的視覺呈現
• Open：註解彈出視窗是否預設為開啟狀態

這些功能讓開發人員能夠建立豐富且具情境關聯的註解，從而提升文件溝通的成效。 若涉及多種文件類型的進階工作流程，建議探索 RTF 轉 PDF 或 Markdown 轉 PDF 功能，以確保不同來源格式間的註解能完整保留。

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

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

在協作文件工作流程中，編輯註解變得至關重要，例如當需要根據修訂內容更新回饋、對含糊的評論進行澄清，或是因內容變更而需重新定位註解時。 此功能可確保文件審閱在整個修訂週期中始終保持最新且切合實際。

在Enterprise環境中，註解編輯功能通常會與審核工作流程整合，主管可能需要修改審閱者的評論後，才能進行最終批准。 此外，當文件進行翻譯或在地化時，註解可能需要更新，以反映語言變更或文化適應。 在此類情境下，IronPDF 的 UTF-8 及國際化語言支援，可確保註解在不同語言與字元集下皆能正確顯示。

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

如何刪除單一註解？

:path=/static-assets/pdf/content-code-examples/how-to/annotation-remove-single-annotation.cs

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

如何一次移除所有註解？

若要移除特定頁面上的所有註解，請使用 RemoveAllAnnotationsForPage 方法並指定頁面索引。 若要移除整份文件中的所有註解，請在 Annotations 屬性上呼叫 Clear 方法。

此批量移除功能在準備文件進行最終發佈時，或在實作文件版本控制系統時（需移除先前審閱週期的註解）特別實用。 建議結合元資料編輯功能，以更新文件屬性並標示審閱狀態。 若工作流程需要經過淨化的文件，請探索 [PDF 淨化](https://ironpdf.com/how to sanitize-pdf/)選項，以移除所有潛在的敏感資訊，包括註解。

:path=/static-assets/pdf/content-code-examples/how-to/annotation-remove-all-annotation.cs

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

何時該使用批量註解移除功能？

批量移除功能非常適合用於最終定稿文件以供發佈、建立乾淨版本以供歸檔，或實施文件版本控制時（需清除先前審閱週期中的註解）。 相較於逐一移除註解，此方法能節省時間，並確保審閱評論不會意外殘留於正式文件中。

此外，當為可能無法正確處理註解的自動化處理系統準備文件，或將帶有註解的 PDF 轉換為其他格式時，批量移除註解至關重要。 在高安全性環境中，於分發前移除所有註解，可避免無意間洩露內部審查意見或不應向外部受眾公開的敏感回饋。

座標系統為何對註解如此重要？

以左下角為起點的 PDF 座標系統，可能會讓習慣以左上角為起點系統的開發人員感到困惑。 座標計算錯誤可能會導致註解出現在意料之外的位置，進而遮蔽重要內容或顯示在頁面之外。 在與 UI 框架或使用者輸入系統整合時，請務必適當轉換座標。

在實作"點擊註解"等功能，或將使用者互動產生的螢幕座標轉換為 PDF 座標時，理解座標系統的重要性便顯得更加關鍵。 若面臨複雜的定位需求，建議利用 IronPDF 的視口與 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")

若要在高負載情境下獲得更佳效能，建議採用非同步處理或多執行緒技術，以並行處理註解操作。

在確保跨瀏覽器相容性時，我應考慮哪些因素？

不同的 PDF 檢視器可能會以不同的圖示樣式、彈出視窗行為或定位方式來呈現註解。 請務必在 Adobe Acrobat、Chrome、Edge 及行動版 PDF 閱讀器等常見檢視工具中測試您的註解 PDF 檔案，以確保註解在使用者可能使用的各平台上皆能正確顯示且功能正常。

部分瀏覽器可能不支援所有註解類型，或顯示方式有所不同。 為確保最佳相容性，請採用標準註解類型，並避免依賴特定檢視器的功能。 在部署至 Azure 或 AWS 等特定環境時，請於目標環境的預設 PDF 檢視器中測試註解功能，以確保行為一致。

準備好探索更多可能性了嗎？ 請點此查看我們的教學頁面：編輯 PDF