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

如何使用IronXL在 C# 中清除 Excel 儲存格

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

IronXL提供了 ClearContents() 方法,可以在 C# 中立即從 Excel 儲存格中刪除數據,只需一行程式碼即可清除單一儲存格、區域、行或列中的值或公式,同時保留格式。 與Excel Interop 的替代方案不同, IronXL不需要安裝 Microsoft Excel,並且可以在 Windows、Linux 和 macOS 平台上無縫運作。

使用儲存格清除功能可以刪除不需要的或過時的資料、重設儲存格值、清理電子表格佈局、準備範本或修復資料輸入錯誤。 在自動化工作流程中以程式設計方式編輯 Excel 檔案時,此功能至關重要。

快速入門:一次通話即可移除儲存格內容

使用IronXL,只需一行程式碼即可清除任何單元格區域的內容——無需循環或複雜的 API。 ClearContents() 方法在刪除資料或公式時保留格式。 在 C# 應用程式中使用 Excel時,這種方法比傳統方法要簡單得多。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronXl.Excel

    PM > Install-Package IronXl.Excel
  2. 複製並運行這段程式碼。

    workSheet["D6:F9"].ClearContents();
  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronXL

    arrow pointer


如何清除單一儲存格?

使用 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");
$vbLabelText   $csharpLabel

為什麼 ClearContents 會保留格式?

ClearContents 方法保留儲存格格式,因為它只刪除資料值和公式,而保留樣式、邊框、字體和顏色。 這種設計允許開發人員在更新資料的同時保持電子表格外觀的一致性。 單元格屬性(如背景圖案和顏色邊框和對齊方式以及字體樣式)保持不變,確保電子表格的視覺設計在資料操作期間保持一致。

何時應該使用單細胞清除?

單細胞清除可實現對資料清除的精確控制。 常見應用場景包括:

  • 更正財務報告中的個別資料輸入錯誤
  • 在共享之前從特定細胞中刪除敏感訊息
  • 清除計算結果,同時保留相鄰儲存格中的公式
  • 重置基於 Excel 的表單中的使用者輸入字段
  • 更新資料驗證場景中的特定資料點

如何清除蜂窩數據?

對任意大小的區域執行 ClearContents 方法。區域清除的靈活性使其非常適合在企業應用程式中管理工作表時進行大量資料操作。 例如:

  • 清除單一儲存格:
    • workSheet["A1"].ClearContents()
  • 清除一列:
    • workSheet.GetColumn("B").ClearContents()
  • 清除一行:
    • workSheet.GetRow(3).ClearContents()
  • 清除二維區域(多行和多列):
    • workSheet["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");
$vbLabelText   $csharpLabel

對於複雜的範圍操作,可以將清除操作與其他IronXL功能(例如選擇範圍對單元格進行排序)結合使用,以建立強大的資料處理工作流程。

清除行和清除列有什麼差別?

行清除和列清除在範圍和對資料結構的影響方面有所不同:

清除行:

  • 刪除電子表格中所有水平方向的數據
  • 可用於刪除完整的記錄或條目
  • 維護列標題和垂直資料關係
  • 非常適合類似資料庫的結構,其中每一行代表一筆完整的記錄。

清除列:

  • 刪除電子表格中垂直向下的所有數據
  • 非常適合刪除整個資料類別或字段
  • 維護基於行的關係和記錄完整性
  • 用於重構資料模式或刪除不必要的屬性

射程選擇如何影響效能?

範圍選擇對處理大型資料集的效能有顯著影響。 清除特定範圍(例如 "A1:Z1000")比循環清除單一儲存格效率更高。 IronXLIronXL最佳化了大量操作,因此基於範圍的清除是效能關鍵型應用的首選方法。 處理大型資料集時,使用命名範圍可以提高程式碼的可讀性和可維護性。

合併儲存格被清除後會發生什麼?

使用 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");
$vbLabelText   $csharpLabel

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

在Excel自動化中,清除所有工作表有以下幾個用途:

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

清空所有工作表後,工作簿會發生什麼變化?

清空所有工作表後,工作簿將變成一個空容器。 儲存前至少新增一個工作表,因為 Excel 要求每個工作簿至少包含一個工作表。 如果您嘗試儲存空白工作簿, IronXL會自動處理此要求。 這種行為符合 Excel 的基本結構,並確保了不同 Excel 版本和應用程式之間的檔案相容性。

若要了解更進階的工作表操作,請查閱 IronXL 的綜合API 參考文檔,以發現更多用於工作表操作和資料處理的方法。

常見問題解答

如何使用 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 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

準備好開始了嗎?
Nuget 下載 1,890,100 | 版本: 2026.3 剛剛發布

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

還在捲動嗎?

想要快速證明? PM > Install-Package IronXl.Excel
執行範例 觀看您的資料變成試算表。