1. IronXL
  2. 操作指南
  3. 清除儲存格
如何使用 C# | IronXL.Excel 清除 Excel 中的儲存格內容

如何在 C# 中使用 IronXL 清除 Excel 單元格。

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL.Excel 提供 ClearContents() 方法，用 C# 即時移除 Excel 單元格中的資料，只需一行程式碼，即可保留格式，同時清除單一單元格、範圍、行或列中的值或公式。 與 Excel Interop alternatives 不同，IronXL.Excel 不需要安裝 Microsoft Excel，並且可以在 Windows、Linux 和 macOS 平台上無縫運作。

使用儲存格清除功能來移除不需要或過時的資料、重設儲存格值、清理試算表佈局、準備範本或修正資料輸入錯誤。 在自動化工作流程中以程式化方式編輯 Excel 檔案時，此功能是不可或缺的。

快速入門：透過一次呼叫刪除儲存格內容

使用 IronXL 只需一行程式碼即可清除任何儲存格範圍的內容 - 不需要循環或複雜的 API。 ClearContents() 方法在移除資料或公式的同時保留格式。 在處理 Excel in C# 應用程式時，這種方法比傳統方法簡單得多。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 IronXL

    PM > Install-Package IronXL.Excel

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

    workSheet["D6:F9"].ClearContents();

  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronXL，免費試用！
    arrow pointer
### 最小工作流程（5 個步驟）
  1. 下載用於清除單元格內容的 C# 庫
  2. 載入現有的Excel試算表
  3. 選擇要清除的範圍、行或列
  4. Invoke the `ClearContents` method on the selected range
  5. Use the `Clear` method to delete all worksheets


如何清除單一單元？

使用 ClearContents 方法清除選取儲存格的內容。 此方法可移除特定的資料點，同時維持試算表的整體結構與格式。 當 載入試算表進行資料處理時，您可能需要根據特定條件清除個別儲存格。

:path=/static-assets/excel/content-code-examples/how-to/clear-cells-clear-single-cell.cs
using IronXL;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Data");

// Clear cell content
workSheet["A1"].ClearContents();

workBook.SaveAs("clearSingleCell.xlsx");
Imports IronXL

Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.GetWorkSheet("Data")

' Clear cell content
workSheet("A1").ClearContents()

workBook.SaveAs("clearSingleCell.xlsx")
$vbLabelText   $csharpLabel

為什麼 ClearContents 會保留格式？

ClearContents 方法會保留儲存格格式，因為它只移除資料值和公式，而不改變樣式、邊框、字型和顏色。 此設計可讓開發人員在更新資料時維持一致的試算表外觀。 儲存格屬性，例如 背景圖案和顏色、邊界和對齊方式，以及 字體樣式，則維持不變，以確保您的試算表在資料作業過程中保持視覺設計的一致性。

何時該使用單細胞清除？

單格清除可精確控制資料移除。 常見的使用案例包括

  • 更正財務報告中的個別資料輸入錯誤
  • 在分享前移除特定單元格中的敏感資訊
  • 清除計算結果，同時在相鄰的儲存格中保留公式
  • 在基於 Excel 的表單中重設使用者輸入欄位
  • 更新 資料驗證場景中的特定資料點

如何清除儲存格範圍？

對任何範圍執行 ClearContents 方法，不論其大小。範圍清除的靈活性使其成為在企業應用程式中 管理工作表時進行大量資料作業的完美工具。 範例包括

  • 清除一個單元格：
    • workSheet["A1"].ClearContents()
  • 清除一列：
    • workSheet.GetColumn("B").ClearContents()工作表。
  • 清除一行：
    • workSheet.GetRow(3).ClearContents()工作表。
  • 清除二維範圍（多行多列）：
    • 工作表["D6:F9"].ClearContents()
:path=/static-assets/excel/content-code-examples/how-to/clear-cells-clear-cell-range.cs
using IronXL;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Data");

// Clear a single cell(A1)
workSheet["A1"].ClearContents();

// Clear a column(B)
workSheet.GetColumn("B").ClearContents();

// Clear a row(4)
workSheet.GetRow(3).ClearContents();

// Clear a two-dimensional range(D6:F9)
workSheet["D6:F9"].ClearContents();

workBook.SaveAs("clearCellRange.xlsx");
Imports IronXL

Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.GetWorkSheet("Data")

' Clear a single cell(A1)
workSheet("A1").ClearContents()

' Clear a column(B)
workSheet.GetColumn("B").ClearContents()

' Clear a row(4)
workSheet.GetRow(3).ClearContents()

' Clear a two-dimensional range(D6:F9)
workSheet("D6:F9").ClearContents()

workBook.SaveAs("clearCellRange.xlsx")
$vbLabelText   $csharpLabel

對於複雜的範圍操作，請結合清除與其他 IronXL 功能，例如 選擇範圍 或 排序儲存格，以建立強大的資料處理工作流程。

清除行與列之間有何差異？

行和列的清除在範圍和對您的資料結構的影響上有所不同：

清除行數：

  • 橫向移除試算表上的所有資料
  • 有助於移除完整的記錄或條目
  • 保持欄頭和垂直資料關係
  • 適用於類似資料庫的結構，其中每一行代表一條完整的記錄

清除欄位：

  • 刪除試算表垂直向下的所有資料
  • 非常適合移除整個資料類別或欄位
  • 保留以行為基礎的關係和記錄完整性
  • 在重組資料模式或移除不必要的屬性時使用

範圍選擇如何影響效能？

範圍選擇會顯著影響大型資料集的效能。 清除特定範圍如 "A1:Z1000" 比在循環中清除個別儲存格更有效率。IronXL 在內部優化了大量操作，使得基於範圍的清除成為性能關鍵應用程式的首選方法。 在處理大量資料集時，請使用 命名範圍，以提高程式碼的可讀性和維護性。

清除合併的儲存格時會發生什麼情況？

使用 ClearContents() 清除合併的單元格，只移除內容，合併的內容保持不變。 單元格保持合併，保留版面結構。 在使用格式化的報表或範本時，這種行為很重要，因為在這些範本中，合併的單元格會建立標題或視覺群組。 若要取消合併儲存格，請在清除內容後使用其他方法。

Spreadsheet with 6x10 cell range A1:F10 containing sample data before clearing operation

前

Spreadsheet showing highlighted cell ranges A2-C3, D5-F5, and D10-F10 with red borders for clear range operations

後

如何清除所有工作表？

使用工作表集合上的 Clear 方法刪除工作簿中的所有工作表。 此方法可一次移除所有工作表，提供將工作簿重設為初始狀態的便利方式。 當 建立新的試算表或重新使用現有的工作簿結構時，此功能會有所幫助。

:path=/static-assets/excel/content-code-examples/how-to/clear-cells-clear.cs
using IronXL;

WorkBook workBook = WorkBook.Load("sample.xlsx");

// Delete all worksheets
workBook.WorkSheets.Clear();

workBook.SaveAs("useClear.xlsx");
Imports IronXL

Private workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Delete all worksheets
workBook.WorkSheets.Clear()

workBook.SaveAs("useClear.xlsx")
$vbLabelText   $csharpLabel

為什麼我需要清除所有工作表？

清除所有工作表在 Excel 自動化中有幾種用途：

1.範本重設：清除工作表，以便在使用 Excel 檔案作為範本時，為新的資料匯入提供一個乾淨的平台 2.記憶體最佳化：在處理多個 Excel 檔案時有效管理記憶體使用量 3.資料安全性：在檔案重複使用之前徹底消除敏感資料 4.工作流程自動化：防止批次處理情境中迭代之間的資料污染 5.測試與開發：在測試週期中將工作簿重設為初始狀態

清除所有工作表後，工作簿會發生什麼變化？

清除所有工作表後，工作簿仍是一個空容器。 儲存前至少新增一個工作表，因為 Excel 要求每個工作簿至少有一個工作表。 如果您嘗試儲存空白工作簿，IronXL 會自動處理此需求。 此行為與 Excel 的基本結構一致，並確保不同 Excel 版本和應用程式之間的檔案相容性。

如需進階的工作表操作，請探索 IronXL 全面的 API Reference 以發現工作表操作和資料處理的其他方法。

常見問題解答

如何使用 C# 清除 Excel 中的儲存格內容？

使用 IronXL 的 ClearContents() 方法在 C# 中移除 Excel 單元格中的資料。此方法可保留儲存格格式，同時只需一行代碼（如 workSheet["D6:F9"].ClearContents()）即可清除單一儲存格、範圍、行或列中的值或公式。

清除儲存格會移除 Excel 試算表中的格式嗎？

不，IronXL 的 ClearContents() 方法僅移除資料值和公式，同時保留所有儲存格格式，包括樣式、邊框、字型、顏色、背景圖案和對齊設定。

我可以在 C# 中一次清除多個儲存格嗎？

是的，IronXL 允許您使用單一指令清除整個儲存格範圍。您可以指定任何範圍，例如「D6:F9」，以同時清除多個儲存格，而無需使用循環或複雜的 API。

我需要安裝 Microsoft Excel 才能以程式方式清除儲存格嗎？

不，IronXL 不需要在您的系統上安裝 Microsoft Excel。它可以在 Windows、Linux 和 macOS 平台上獨立運作，因此非常適合伺服器環境。

清除儲存格與刪除工作表有何不同？

IronXL 提供 ClearContents() 方法來移除儲存格中的資料，同時保持結構完整，並提供 Clear() 方法來刪除整個工作表。ClearContents 可保留格式和工作表佈局，而 Clear 則可完全移除工作表。

何時應該使用單一單元格清除與範圍清除？

根據條件更新特定資料點時，使用 IronXL 的單一儲存格清除功能進行精確控制。當您需要重設整個區段、準備範本或在自動化工作流程中有效率地清理多個儲存格時，請使用範圍清除。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術撰稿人

Curtis Chau 擁有電腦科學學士學位（卡爾頓大學），專長於前端開發，精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情，他喜歡使用現代化的架構，並製作結構良好且視覺上吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 也有濃厚的興趣，他喜歡探索整合硬體與軟體的創新方式。在空閒時間，他喜歡玩遊戲和建立 Discord bots，將他對技術的熱愛與創意結合。

準備好開始了嗎？
Nuget 下載 1,846,091 | 版本： 2026.2 剛剛發布