使用IronXL在C#中編輯Excel公式

Updated: 2026年6月29日

IronXL允許您在C#中透過在任意格子上設定EvaluateAll()重新計算工作簿中的所有公式。 Formula EvaluateAll() Formula FormattedCellValue 本程式庫支援超過165個Excel公式，並確保在格子值更改時動態更新。

Excel公式是一種以等號（=）開始的表達式，用於數學計算、資料處理和根據格子值導出結果。它可能包含算術、函式、格子引用、常數和邏輯運算。當格子值更改時，公式可以進行動態更新，使Excel成為自動化任務和資料分析的多功能工具。 IronXL支援編輯現有的公式在Excel文件中，檢索公式的結果，並強制重新評估工作簿。這確保每個公式將被重新計算以獲得準確的結果。 IronXL支援超過165個公式。

快速入門：即時更改一個格子公式

使用IronXL的Formula屬性在任何格子上設定或更新公式。然後調用EvaluateAll()以重新計算所有公式—快速入門並確保更新的結果。

1Install IronXL with NuGet Package Manager
PM > Install-Package IronXL.Excel
```
Install-Package IronXL.Excel
```

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

IronXL.WorkBook.Load("MyFile.xlsx").DefaultWorkSheet["B2"].Formula = "=AVERAGE(C1,C2)";
workBook.EvaluateAll();

IronXL.WorkBook.Load("MyFile.xlsx").DefaultWorkSheet["B2"].Formula = "=AVERAGE(C1,C2)";
workBook.EvaluateAll();

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

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

最小工作流（5步）

下載C#程式庫以在工作表中編輯公式
建立一個新的Excel文件或匯入一個現有的文件
編輯或設定Formula屬性以將公式分配給格子
透過存取格子的Value屬性檢索結果值
匯出編輯後的Excel文件

為什麼IronXL是編輯公式的最佳選擇？

IronXL消除了對Microsoft Office Interop的需求，同時提供透過直觀屬性直接存取公式的功能。本程式庫支援超過165個內建的Excel函式，自動處理復雜的公式依賴性，並提供快速處理可在Windows、Linux和macOS平台上運行。其輕量級架構確保Excel相容的計算而無需外部依賴。

系統需求是什麼？

IronXL需要.NET Framework 4.6.2或更高版本，或.NET Core 2.0及以上版本。本程式庫可在Windows、Linux和macOS上運行而不需要安裝Microsoft Excel。為了在包含復雜公式的大型工作簿中獲得最佳效能，我們建議至少使用4GB的RAM。查看完整的文件以獲取詳細的平台特定需求。

如何開始使用IronXL？

使用套件管理器控制台與Install-Package IronXL.Excel安裝NuGet包。安裝後，應用您的授權金鑰以解鎖完整功能。在您的C#文件中匯入IronXL命名空間以開始編輯公式。直觀的API設計允許您在幾分鐘內載入Excel文件並修改公式。

如何使用C#編輯Excel公式？

要編輯或設置公式，請存取**Formula屬性。首先，選擇一個範圍或格子，然後存取並設置Formula**屬性。 **Formula屬性既是獲取又是設定屬性，如果有，則返回公式字串。調用EvaluateAll()**方法以重新評估整個工作簿，確保準確的計算。

using IronXL;

// Load workbook
WorkBook workBook = WorkBook.Load("Book1.xlsx");

// Select worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Edit or Set formula
workSheet["A4"].Formula = "=SUM(A1,A3)";

// Reevaluate the entire workbook
workBook.EvaluateAll();

using IronXL;

// Load workbook
WorkBook workBook = WorkBook.Load("Book1.xlsx");

// Select worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Edit or Set formula
workSheet["A4"].Formula = "=SUM(A1,A3)";

// Reevaluate the entire workbook
workBook.EvaluateAll();

Imports IronXL

' Load workbook
Private workBook As WorkBook = WorkBook.Load("Book1.xlsx")

' Select worksheet
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Edit or Set formula
Private workSheet("A4").Formula = "=SUM(A1,A3)"

' Reevaluate the entire workbook
workBook.EvaluateAll()

Imports IronXL

' Load workbook
Private workBook As WorkBook = WorkBook.Load("Book1.xlsx")

' Select worksheet
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Edit or Set formula
Private workSheet("A4").Formula = "=SUM(A1,A3)"

' Reevaluate the entire workbook
workBook.EvaluateAll()

IronXL在處理公式時提供完全的靈活性。您可以修改現有公式，建立新的公式，或根據運行時條件構建動態公式。本程式庫自動處理公式語法驗證，確保Excel相容性。對於復雜情況，探索全面的公式範例展示高級操作技巧。

為什麼在編輯公式後應使用`EvaluateAll()`？

**EvaluateAll()**方法維護您Excel工作簿中的資料完整性。當您修改一個公式時，整個工作簿的從屬格子可能需要重新計算。 EvaluateAll()會觸發一個完整的工作簿重新計算，確保所有公式反映最新的更改。這在處理級聯公式時至關重要，其中一個格子的結果影響多個計算。不調用EvaluateAll()，您可能會導出過時的值，導致資料不一致。

如果我不重新計算工作簿會發生什麼？

跳過重新計算可能會導致重大問題。 Excel文件同時儲存公式及其快取結果。當您修改公式而不重新計算時，快取值保持不變，建立了公式和其顯示結果之間的不匹配。當使用者在Excel中打開文件時，這種差異將變得明顯，他們將看到與期望不同的值。任何依賴這些公式結果的後續操作將使用過時的資料，這可能會在後續流程中導致錯誤。

我可以一次編輯多個公式嗎？

是的，IronXL支援通過範圍操作的批量公式編輯。使用類似**workSheet["A1:A10"]**的範圍表示法選擇多個格子，然後同時對所有格子應用公式。對於複雜的模式，遍歷格子集合並應用條件邏輯來設置基於格子位置或現有值的不同公式。此方法在建立電子表格時效果很好，帶有重複的公式模式或以程式方式更新大型資料集。

如何從公式中檢索結果？

要從公式中檢索結果，使用格子的**FormattedCellValue屬性以獲得準確的結果。在選定範圍內，使用First方法存取格子，選擇序列的第一個元素。從那裡存取FormattedCellValue**屬性。

using IronXL;
using System;
using System.Linq;

// Load workbook
WorkBook workBook = WorkBook.Load("Book1.xlsx");

// Select worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Retrieve the result value
string value = workSheet["A4"].First().FormattedCellValue;

// Print the result to console
Console.WriteLine(value);

using IronXL;
using System;
using System.Linq;

// Load workbook
WorkBook workBook = WorkBook.Load("Book1.xlsx");

// Select worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Retrieve the result value
string value = workSheet["A4"].First().FormattedCellValue;

// Print the result to console
Console.WriteLine(value);

Imports IronXL
Imports System
Imports System.Linq

' Load workbook
Private workBook As WorkBook = WorkBook.Load("Book1.xlsx")

' Select worksheet
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Retrieve the result value
Private value As String = workSheet("A4").First().FormattedCellValue

' Print the result to console
Console.WriteLine(value)

Imports IronXL
Imports System
Imports System.Linq

' Load workbook
Private workBook As WorkBook = WorkBook.Load("Book1.xlsx")

' Select worksheet
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Retrieve the result value
Private value As String = workSheet("A4").First().FormattedCellValue

' Print the result to console
Console.WriteLine(value)

**FormattedCellValue屬性將返回格子中的值，格式尊重數字格式、日期格式和自定義格式規則。這確保程式化輸出與使用者在Excel中看到的保持一致。對於數值分析，透過Value**屬性存取原始值，返回未應用格式的底層數字或文字資料。

為什麼使用`Value`屬性？

**FormattedCellValue提供格子內容即用的表示，對於在應用程式中維持Excel的視覺格式至關重要。雖然FormattedCellValue**應用了Excel的格式規則，包括數字格式、貨幣符號、百分比顯示和日期格式。在生成報告或向最終使用者顯示資料時，這種區別變得至關重要，他們期望值的格式與他們的Excel體驗一致。有關詳細的格式選項，請參閱API參考。

格子值與公式結果有什麼區別？

一個格子的公式是表達式（如"=A1+B1"），而公式結果是計算後的值（如"150"）。 IronXL透過不同的屬性分離這些觀念：FormattedCellValue表示結果。這種分離允許您檢查公式以進行審計，程式化地修改計算或提取結果以供進一步處理。有些格子包含無公式的靜態值，其中**Value**仍提供格子的內容。

如何處理公式錯誤？

Excel中的公式錯誤（如#DIV/0!、#VALUE!、或#REF!）需在C#程式碼中特別處理。 IronXL將保留這些錯誤狀態，允許檢測和程式化響應。透過**FormattedCellValue屬性的字串比較檢查格子是否包含錯誤，或在數值處理公式結果時實施try-catch塊。為了進行健壯的錯誤處理，考慮在公式評估前進行驗證邏輯，或在公式中使用Excel的IFERROR**函式提供後備值。了解更多關於故障排除常見問題。

IronXL支援哪些Excel公式？

Excel包含超過450個用於各種計算目的的公式。 IronXL支援約165個最常用的公式。檢查以下內容以獲得支援的公式：

公式名稱	描述
ABS	返回數字的絕對值，不考慮其符號。
INT	將數字向下取整為最接近的整數。
COUNT	計算指定範圍內包含數字的格子的數目。
IF	執行條件測試，若條件為真則返回一個值，若為假則返回另一個值。
SUM	將一範圍的數字相加。
AVERAGE	計算一範圍數字的平均值。
MIN	返回一組數字中的最小值。
MAX	返回一組數字中的最大值。
ROW	返回一個格子引用的行號。
COLUMN	返回一個格子引用的列號。
NA	表示錯誤值"不可用"或遺失的資料。
NPV	計算在指定折扣率下的現金流系列的淨現值。
STDEV	計算一組數字的標準差。
SIGN	返回數字的符號-1為負，0為零，1為正。
ROUND	將數字四捨五入到指定的小數位數。
LOOKUP	在一個範圍中搜索一個值並返回另一個範圍中的相應值。
INDEX	返回指定範圍中給定行和列的格子的值。
REPT	重複一個文字字串指定的次數。
MID	從給定的文字字串中根據指定的起始位置和長度提取文字的一部分。
LEN	返回一個文字字串中的字元數。
VALUE	將表示數字的文字字串轉換為實際數字。
TRUE	代表邏輯值"True"。
FALSE	代表邏輯值"False"。
AND	檢查所有指定條件是否為真，如果是則返回"True"，否則返回"False"。
OR	檢查至少一個指定條件是否為真，如果是則返回"True"，否則返回"False"。
NOT	反轉一個條件的邏輯值，將"True"轉為"False"，反之亦然。
MOD	返回一個數字除以另一個數字的餘數。
DMIN	提取基於指定條件的資料庫中的最小值。
VAR	計算一組數字的方差。
TEXT	使用指定的格式將數字轉換為文字。
PV	基於一系列現金流和折扣率計算投資或貸款的現值。
FV（未來值）	基於定期付款和指定利率計算投資或貸款的未來值。
NPER（期數）	確定在給定定期付款和利率的情況下達到某一財務目標所需的付款期數。
PMT（付款）	計算支付貸款或投資所需的定期付款，包含本金和利息。
RATE（利率）	計算達到財務目標所需的利率，包括定期付款。
MIRR（修正的內部收益率）	計算一系列現金流的內部收益率，考慮多種再投資和融資率。
IRR（內部收益率）	計算一系列現金流的內部收益率，指示投資達到盈虧平衡的利率。
RAND	生成0到1之間的隨機小數。
MATCH	在一個範圍中搜索指定的值並返回找到的項目的相對位置。
DATE	透過指定年份、月份和日期建立日期值。
TIME	透過指定小時、分鐘和秒建立時間值。
DAY	從給定的日期中提取日期。
MONTH	從給定的日期中提取月份。
YEAR	從給定的日期中提取年份。
WEEKDAY	返回指定日期的一周中的星期幾。
HOUR	從給定的時間中提取小時。
MINUTE	從給定的時間中提取分鐘。
SECOND	從給定的時間中提取秒。
NOW	返回當前日期和時間。
AREAS	計算一個引用中的單獨範圍數量。
ROWS	計算指定範圍中的行數。
COLUMNS	計算指定範圍中的列數。
OFFSET	透過某一行和列數量偏移量返回一個指定格子的引用。
SEARCH	在一個文字字串中搜索子字串並返回其位置。
TRANSPOSE	轉置範圍的行和列。
ATAN2	計算指定x和y座標的反正切。
ASIN	計算指定值的反正弦。
ACOS	計算指定值的反餘弦。
CHOOSE	從值列表中根據指定位置返回一個值。
HLOOKUP	在表或範圍的頂行中搜索一個值，並從指定行中返回同一列中的值。
VLOOKUP	在表或範圍的首列中搜索一個值，並從指定列中返回同一行中的值。
ISREF	檢查一個值是否為參考，若是則返回"True"，若不是則返回"False"。
LOG	計算一個數字的對數，取指定的底數。
CHAR	返回由給定數字指定的字元。
LOWER	將文字轉換為小寫。
UPPER	將文字轉換為大寫。
PROPER	將文字字串中每個單詞的首字母大寫。
LEFT	從文字字串的開頭提取指定的字元數量。
RIGHT	從文字字串的結尾提取指定的字元數量。
EXACT	比較兩個文字字串，如果相同則返回"True"，不相同則返回"False"。
TRIM	從文字字串中移除多餘的空格，保留單詞間的單一空格。
REPLACE	在文字字串中用新的文字替換指定數量的字元。
SUBSTITUTE	在文字字串中用新的文字替換指定文字的出現次數。
CODE	返回文字字串中第一個字元的數字Unicode值。
FIND	在文字字串中搜索特定的子字串並返回其位置。
ISERR	檢查一個值是否為錯誤值而非"#N/A"，若是則返回"True"，若不是則返回"False"。
ISTEXT	檢查一個值是否為文字，若是則返回"True"，若不是則返回"False"。
ISNUMBER	檢查一個值是否為數字，若是則返回"True"，若不是則返回"False"。
ISBLANK	檢查一個格子是否為空，若是則返回"True"，若不是則返回"False"。
T	將一個值轉換為文字格式。
DATEVALUE	將作為文字表示的日期轉換為日期序列號。
CLEAN	從文字中移除不可列印字元。
MDETERM	計算一個陣列的矩陣行列式。
MINVERSE	返回矩陣的相乘反數（倒數）。
MMULT	將兩個矩陣相乘。
IPMT	計算特定期間貸款付款中的利息部分。
PPMT	計算特定期間貸款付款中的本金部分。
COUNTA	計算範圍內的非空格子的數量，包括文字和數字。
PRODUCT	將範圍內的所有數字相乘。
FACT	計算一個數字的階乘。
ISNONTEXT	檢查一個值是否不是文字，若不是文字則返回"True"，若是文字則返回"False"。
VARP	基於樣本估計母體的方差。
TRUNC	將數字截斷到指定的小數位數。
ISLOGICAL	檢查一個值是否為邏輯（布林）值，若是則返回"True"，若不是則返回"False"。
USDOLLAR	將數字轉換為帶有貨幣符號和兩個小數位的文字格式。
ROUNDUP	將數字向上取整到指定的小數位數。
ROUNDDOWN	將數字向下取整到指定的小數位數。
RANK	返回列表中一個數字的排名，並有選項處理並列情況。
ADDRESS	根據行號和列號返回格子地址作為文字。
DAYS360	使用360天年計算兩個日期之間的天數。
TODAY	返回當前日期。
MEDIAN	返回一組數字的中位數（中間值）。
SUMPRODUCT	相乘陣列中的對應部分並返回乘積之和。
SINH	計算一個數字的雙曲正弦。
COSH	計算一個數字的雙曲餘弦。
TANH	計算一個數字的雙曲正切。
ASINH	計算一個數字的反雙曲正弦。
ACOSH	計算一個數字的反雙曲餘弦。
ATANH	計算一個數字的反雙曲正切。
ExternalFunction	表示由外部附加程式或自定義函式提供的函式調用或操作。
ERRORTYPE	返回一個對應於給定值中錯誤型別的數字。
AVEDEV	計算一組值從平均值的平均絕對偏差。
COMBIN	計算從較大集合選擇若干項的組合數目。
EVEN	將數字向上取整為最近的偶數整數。
FLOOR	將數字向下取整到指定意義的最近倍數。
CEILING	將數字向上取整為指定意義的最近倍數。
NORMDIST	計算指定值的累積正態分佈函式。
NORMSDIST	計算標準正態累積分佈函式。
NORMINV	計算對應於指定概率的正態累積分佈函式的反函式。
NORMSINV	計算標準正態累積分佈函式的反函式。
STANDARDIZE	將值轉換為平均值為0且標準差為1的標準正態分布。
ODD	將數字向上取整為最近的奇數整數。
POISSON	計算給定事件數目下的泊松分佈概率。
TDIST	計算指定值及自由度的Student's t-分布。
SUMXMY2	計算兩個陣列中對應值之差的平方和。
SUMX2MY2	計算兩個陣列中對應值之差的平方和。
SUMX2PY2	計算兩個陣列中對應值之和的平方和。
INTERCEPT	計算趨勢線在圖表中與y-軸交叉的點。
SLOPE	計算圖表中趨勢線的斜率。
DEVSQ	返回資料點從平均值偏差的平方和。
SUMSQ	計算一組數字的平方和。
LARGE	返回資料集中第k大的數值，其中k為指定值。
SMALL	返回資料集中第k小的數值，其中k為指定值。
PERCENTILE	返回資料集中第k百分數的位置，其中k為指定值。
PERCENTRANK	返回資料集中一個值的排名作為總值數量的百分比。
MODE	返回資料集中最頻繁出現的值。
CONCATENATE	將多個文字字串合併為一個。
POWER	將數字提升到指定的冪。
RADIANS	將度數轉換為弧度。
DEGREES	將弧度轉換為度數。
SUBTOTAL	對範圍進行各種計算（如，和、平均），您可選擇是否包含或不包括範圍內的其他SUBTOTAL結果。
SUMIF	將符合指定條件的範圍內的所有數字相加。
COUNTIF	計算範圍中符合指定條件的格子的數量。
COUNTBLANK	計算範圍中空白格的數量。
ROMAN	將阿拉伯數字轉換為羅馬數字。
HYPERLINK	建立到網站或文件的超連結。
MAXA	返回一組數字中，包括文字和邏輯值的最大值。
MINA	返回一組數字中，包括文字和邏輯值的最小值。

我應該最常使用哪些公式？

商業應用中最常使用的公式包括**VLOOKUP函式。對於金融應用，使用IRR函式。統計分析受益於PERCENTILE函式。文字操作依賴於TRIM**函式。理解這些核心公式使得可以透過組合構建複雜的計算。 IronXL的全面公式支援確保您的C#應用程式能處理任何Excel計算需求。

如果我的公式不被支援怎麼辦？

雖然IronXL支援165個以上涵蓋大多數商業需求的公式，但某些專門或更新的Excel函式可能不可用。您有幾個選擇：首先，檢查是否可透過結合支援的公式達到相同的結果。許多複雜的Excel函式可以透過基本的數學運算復制。或者，在C#中直接實現計算邏輯，並將結果作為值寫入格子。對於關鍵未支援的公式，請聯繫IronXL支援來討論可能的增強。開發團隊定期根據使用者反饋更新公式支援。

IronXL是否支援Microsoft 365 (`_xlfn`) 函式?

IronXL通過**EvaluateAll()**評估40多個現代Excel函式，無論是否含有Microsoft 365儲存工作簿時寫入的_xlfn.GCD都被識別）。 _xlfn.SINGLE函式，即Excel的動態-陣列溢出存根，被作為通過返回其標量參數。已正確評估的公式不受影響，並產生相同的結果。

請注意: 由Microsoft 365儲存的工作簿先前在這些函式上失敗，現在可以正確評估。

我可以新增自定義的公式支援嗎？

IronXL專注於支援標準的Excel公式，確保跨不同Excel版本和應用的相容性。雖然您無法直接透過IronXL將自定義公式定義新增到Excel中，但可以建立有效的替代方案。在您的C#應用程式中實作自定義計算邏輯，並使用IronXL讀取輸入值和寫入結果。對於複雜情況，結合多個支援的公式以達成所需結果。此方法保持Excel文件相容性，同時透過C#進行自定義計算。探索IronXL的豐富功能以最大化您的公式自動化能力。

常見問題

我如何在C#中以程式方式編輯Excel公式？

IronXL允許您通過設定任何單元格的Formula屬性在C#中編輯Excel公式。只需載入您的工作簿，存取所需的單元格，並將公式字串以'='開頭指派給Formula屬性。然後調用EvaluateAll()以重新計算工作簿中的所有公式以獲取準確結果。

支援哪些型別的Excel公式？

IronXL支援超過165種內建Excel公式，包括算術操作、數學函式、統計計算、邏輯操作及複雜的公式依賴。該程式庫處理所有標準Excel公式語法，確保與Excel生成的檔案相容。

我如何檢索公式計算的結果？

在用IronXL設置公式後，您可以使用單元格的FormattedCellValue屬性檢索計算後的結果。該屬性以格式化字串返回公式的評估結果，與在Excel中顯示的一樣。

是否需要安裝Microsoft Excel以編輯公式？

不，IronXL獨立運行，無需Microsoft Excel或Office Interop。該程式庫包含自己的公式計算引擎，適用於Windows、Linux和macOS平台，非常適合伺服器環境和跨平台應用程式。

如何確保在變更後重新計算所有公式？

IronXL提供EvaluateAll()方法以重新計算工作簿中的所有公式。在修改單元格值或公式後調用此方法，以確保所有依賴計算用最新資料更新，保持您試算表的準確性。

編輯公式的系統要求是什麼？

IronXL需要.NET Framework 4.6.2或更高版本，或.NET Core 2.0及更高版本。對於複雜公式和大型工作簿，最佳性能需至少4GB的RAM。該程式庫的輕量架構確保高效處理，無外部依賴。

IronXL是否支援現代Microsoft 365 (_xlfn) Excel函式？

是的。IronXL透過EvaluateAll()評估40多種額外的現代Excel函式，無論是否帶有Microsoft 365儲存至工作簿的_xlfn.前綴（例如，GCD和_xlfn.GCD都被識別）。以前在這些函式上拋出NotImplementedFunctionException的工作簿現在正確評估，且_xlfn.SINGLE作為傳遞工具來處理，返回其標量參數。已正確評估的公式會產生相同的結果。

What should I do if a formula isn't supported by IronXL?

If a formula isn't supported by IronXL, you can try achieving the result using a combination of supported formulas, or implement the logic directly in C# and write the result as a cell value. You can also contact IronXL support for further assistance.

Does IronXL support Microsoft 365 functions?

Yes, IronXL evaluates over 40 additional modern Excel functions, including those with the `_xlfn.` prefix used by Microsoft 365. Functions such as `GCD` and `_xlfn.GCD` are recognized by IronXL.

How does IronXL handle formula errors in Excel?

IronXL preserves Excel formula error states allowing you to detect and respond to them programmatically. You can use string comparison to identify errors or implement error-checking logic in your application for robust handling.