如何使用 C## 在 Excel 中加入註解 (不含 Interop)

使用 IronXL.Excel 簡單的 API 在 C# 中為 Excel 單元格新增註解 - 無需互操作。 只需在任何儲存格上呼叫 AddComment() 即可新增註解、註釋或說明，且不會影響您的儲存格資料。

快速入門：用一行簡單程式碼為儲存格新增註解

只需呼叫一個方法，即可在任何 Excel 單元格中加入註解。 沒有互操作，沒有複雜性 - 只需在單元格上呼叫 AddComment 即可。

```cs:title=使用 IronXL.Excel 在一行中添加 Excel 註解 IronXL.WorkBook.Create().DefaultWorkSheet["B2"].First().AddComment("Quick tip!", "Dev")；

<div class="hsg-featured-snippet">
    <h3>最小工作流程（5 個步驟）</h3>
    <ol>
        <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://nuget.org/packages/IronXL.Excel/">下載 C# 庫以啟用註解功能</a></li>
        <li>打開現有的或創建新的 Excel 試算表</li>
        <li>使用<code>AddComment</code>方法新增註釋</li>
        <li>透過存取<strong>"評論"</strong>屬性來檢索和編輯評論。</li>
        <li>使用<code>RemoveComment</code>方法刪除儲存格中的註釋</li>
    </ol>
</div>
<br class="clear">

<h2>如何在 Excel 單元格中加入註解？

<h3>`AddComment`會接受哪些參數？

選擇單元格，然後使用`AddComment`方法向單元格新增註解。 預設情況下，評論是不可見的。 將滑鼠移至單元格上以查看註解。 `AddComment` 方法接受三個參數：`content` (字串)、`author` (字串) 和 `isVisible` (布林)。 `content` 和 `author` 參數都是可選的，並且可以為空，讓您可以建立空註解或沒有作者屬性的註解。

在您的 .NET 應用程式中使用 Excel 註解時，瞭解 IronXL 如何處理儲存格引用是非常重要的。 如果您是 IronXL 的新使用者，請查看全面的 [ 入門概述](https://ironsoftware.com/csharp/excel/docs/)，瞭解以程式化方式處理 Excel 檔案的基本知識。 對於需要雲端部署的企業應用程式，IronXL.Excel 可與 [Azure 環境](https://ironsoftware.com/csharp/excel/get-started/azure/)和 [AWS Lambda 函式](https://ironsoftware.com/csharp/excel/get-started/aws/)無縫整合。

<h3>何時應該讓注釋預設為可見？

在 Excel 中，註解通常會預設隱藏，以維持整潔的試算表外觀。 然而，您可能希望在建立訓練材料、提供資料輸入的詳細說明，或強調使用者必須立即看到的關鍵資訊等情況下，使用可見的注釋。 將 `AddComment` 的第三個參數設定為 `true` 以使註解不需懸停即可看見。

對於更進階的 Excel 操作任務，包括 [從零開始建立新的試算表](https://ironsoftware.com/csharp/excel/how-to/create-spreadsheet/)，或 [管理現有的工作表](https://ironsoftware.com/csharp/excel/how-to/manage-worksheet/)，IronXL.Excel 提供了一套完整的工具，可以無縫協同運作。 在建立資料驅動的應用程式時，您可能也需要 [ 將 Excel 資料匯出為各種格式](https://ironsoftware.com/csharp/excel/how-to/c-sharp-export-to-excel/)，或 [在不同的試算表類型之間進行轉換](https://ironsoftware.com/csharp/excel/how-to/convert-spreadsheet-file-types/)。

<h3>如果我在已有註解的單元格中新增註解會怎麼樣？

當您在一個已包含註解的單元格中呼叫 `AddComment` 時，IronXL 將以新的註解取代現有的註解。 此行為可確保您不會意外地在單一單元格上建立重複的註解。 如果您需要保留現有的註解內容，請先使用 `Comment` 屬性擷取註解內容，然後在新增更新的註解之前，將內容串接或合併。

```csharp
:path=/static-assets/excel/content-code-examples/how-to/add-comment-add-comment.cs

以下是一個實用的範例，在一個循環中加入註解到多個單元格，對於加入批次註解或驗證註解很有用：

using IronXL;
using System;

// Load an existing workbook
WorkBook workBook = WorkBook.Load("salesData.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Add comments to cells that meet specific criteria
for (int row = 2; row <= 10; row++)
{
    var cell = workSheet[$"D{row}"].First();
    var value = cell.DoubleValue;

    if (value > 1000)
    {
        // Add performance comment for high values
        cell.AddComment($"Excellent performance! Value: {value:C}", "Sales Manager", true);
    }
    else if (value < 500)
    {
        // Add improvement comment for low values
        cell.AddComment($"Needs attention. Current: {value:C}", "Sales Manager", false);
    }
}

// Add timestamp comment to track last update
var updateCell = workSheet["A1"].First();
updateCell.AddComment($"Last updated: {DateTime.Now:yyyy-MM-dd HH:mm}", "System");

workBook.SaveAs("salesDataWithComments.xlsx");

using IronXL;
using System;

// Load an existing workbook
WorkBook workBook = WorkBook.Load("salesData.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Add comments to cells that meet specific criteria
for (int row = 2; row <= 10; row++)
{
    var cell = workSheet[$"D{row}"].First();
    var value = cell.DoubleValue;

    if (value > 1000)
    {
        // Add performance comment for high values
        cell.AddComment($"Excellent performance! Value: {value:C}", "Sales Manager", true);
    }
    else if (value < 500)
    {
        // Add improvement comment for low values
        cell.AddComment($"Needs attention. Current: {value:C}", "Sales Manager", false);
    }
}

// Add timestamp comment to track last update
var updateCell = workSheet["A1"].First();
updateCell.AddComment($"Last updated: {DateTime.Now:yyyy-MM-dd HH:mm}", "System");

workBook.SaveAs("salesDataWithComments.xlsx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

我該如何編輯現有的評論？

Why Does the `Comment` Property Return Null Sometimes? 當選取的儲存格沒有相關的註解時，`Comment` 屬性會回傳 `null` 。 這是以程式化方式迭代儲存格時常見的情況。 在嘗試修改註解屬性之前，請務必檢查 `null` 以避免 `NullReferenceException` 的發生。 此模式類似於 IronXL's [comprehensive API](https://ironsoftware.com/csharp/excel/object-reference/api/) 中的其他單元格屬性。 如果您在處理複雜的 Excel 檔案時遇到意想不到的 `null` 值，[疑難排解指南](https://ironsoftware.com/csharp/excel/troubleshooting/file-size-limits/)可協助您瞭解 IronXL 在不同 Excel 格式和檔案結構下的行為。 對於處理大型 Excel 檔案的效能關鍵應用程式，請參閱 [ 效能里程碑文件](https://ironsoftware.com/csharp/excel/product-updates/milestones-performance/)，以最佳化您的註解作業。

我可以修改註解的哪些屬性？ IronXL 的 `Comment` 物件揭露了三個您可以修改的主要屬性：`Author` (字串)、`Content` (字串) 和 `IsVisible` (布林)。 `Author` 屬性可辨識建立註解的人，對於合作文件非常有用。 `Content` 包含實際的註解文字，支援多行字串以進行詳細註解。 `IsVisible` 控制註解是永久顯示還是僅在懸停時顯示。 這些註解屬性可與其他儲存格格式化功能一起使用。 例如，您可能想要結合註解與 [ 單元格樣式與邊框](https://ironsoftware.com/csharp/excel/how-to/border-alignment/)，以便在試算表中建立視覺上截然不同的註解區段。 您也可以將 [ 條件格式化](https://ironsoftware.com/csharp/excel/how-to/conditional-formatting/)套用至包含註解的單元格，使其在視覺上更為突出。

如何在建立註解後變更其顯示性？ 透過存取儲存格的 `Comment` 屬性，擷取 `Comment` 物件。 根據您的需求，將 `IsVisible` 屬性設定為 `true` 或 `false` 。 此動態控制可讓您根據使用者動作或應用程式邏輯中的特定條件來顯示或隱藏備註。 ```csharp :path=/static-assets/excel/content-code-examples/how-to/add-comment-edit-comment.cs ``` 當[以程式化方式編輯 Excel 檔案](https://ironsoftware.com/csharp/excel/how-to/csharp-edit-excel-file/)時，註解提供了一種非侵入性的方式來新增元資料或備註，而不會改變實際的儲存格數值。 這使得它們成為稽核追蹤、檢閱程序或提供資料變更上下文的完美工具。 對於需要維持資料完整性的應用程式，請考慮 [ 使用密碼保護您的 Excel 檔案](https://ironsoftware.com/csharp/excel/how-to/set-password-workbook/)，同時仍允許註解修改。 * * *

如何從儲存格中移除註解？

移除註解時，儲存格格式會發生什麼變化？ 從儲存格中移除註解不會影響任何其他儲存格的屬性或格式。 儲存格的數值、公式、樣式、邊框和背景顏色保持不變。 這種隔離可確保註解管理作業的安全性，不會在不經意間修改您精心格式化的試算表。 此行為符合 IronXL 保留 [ 工作簿元資料](https://ironsoftware.com/csharp/excel/how-to/edit-workbook-metadata/) 和格式的原則，除非明確修改。

我可以一次移除多個註解嗎？ 雖然 IronXL 並未提供同時移除工作表中所有註解的內建方法，但您可以透過迭代單元格輕鬆實現此功能。 建立一個簡單的循環，檢查每個儲存格是否有註解並將其移除。 此方法提供您精細的控制，讓您可以根據作者、內容關鍵字或單元位置等條件選擇性地移除註解。 Remove a comment from a cell by accessing the cell object and calling the RemoveComment method. 此操作是立即執行的，不需要儲存工作簿即可生效，但您應該儲存變更以將其持久化到磁碟上。 ```csharp :path=/static-assets/excel/content-code-examples/how-to/add-comment-remove-comment.cs ``` Excel 中的注釋有多種用途，不僅僅是簡單的注釋。 在以程式化方式產生報告、提供資料輸入表單的說明，或在協同編輯過程中加入修訂註解時，這些工具對程式碼文件非常有價值。 在處理 [ 資料驗證時](https://ironsoftware.com/csharp/excel/troubleshooting/excel-limitation-data-validation-for-string-lists/)，註解可以提供有關可接受值的有用提示。 對於複雜的資料處理工作流程，您可能會結合註解與 [ 命名範圍](https://ironsoftware.com/csharp/excel/how-to/named-range/)，以建立更容易維護的自我文件化電子表格。 有了 IronXL 簡單直接的 API，管理這些註解變得和其他儲存格操作一樣簡單，使其成為在您的 C# 應用程式中建立專業、檔案完備的 Excel 檔案的必要工具。 無論您是在建立 [ASP.NET 網路應用程式](https://ironsoftware.com/csharp/excel/how-to/asp-net-mvc-read-excel-file/)或桌上型解決方案，IronXL.Excel 的註解功能都能無縫整合至您的工作流程中，而不會產生 COM Interop 的複雜性。