EasyXLS™ library allows you to calculate Excel formulas by defining formulas with functions or loading template Excel files with predefined formulas. The defined spreadsheet can be optionally exported to Excel.
The library can be used as Excel calculation engine. The engine provides all the functions supported by Excel as far as formulas are concerned. It provides arithmetic, logical and unary operators, formulas with numbers, dates and strings, formulas with cell references, formulas with cell ranges, formulas with names and with arrays.
Concept in action
The below example shows how to calculate Excel formulas and read the formula result.
The source code samples can be integrated in:
- ASP.NET web pages - Windows applications - Windows Forms (WinForms) - Console applications - Windows service applications - ASP.NET MVC web applications - PHP and ASP web pages - Java applications
// Create an instance of the class that creates Excel files
ExcelDocument workbook = new ExcelDocument();
// Add a sheet
ExcelWorksheet xlsWorksheet = new ExcelWorksheet("Formula calculation");
workbook.easy_addWorksheet(xlsWorksheet);
// Get the table of data for the sheet
ExcelTable xlsTable = xlsWorksheet.easy_getExcelTable();
// Add data in cells and set the formula
xlsTable.easy_getCell("A1").setValue("1");
xlsTable.easy_getCell("A2").setValue("2");
xlsTable.easy_getCell("A3").setValue("3");
xlsTable.easy_getCell("A4").setValue("4");
xlsTable.easy_getCell("A6").setValue("=SUM(A1:A4)");
// Call the method that computes Excel formulas
String sError = xlsWorksheet.easy_computeFormulas(workbook, true);
if (sError.Length == 0)
Console.WriteLine("Formulas computed successfully");
else
Console.WriteLine("Error computing formulas! Error: " + sError);
// Read formula result
Console.WriteLine("The result of the formula entered at position A6 is: " +
xlsTable.easy_getCell(5,0).getFormulaResultValue());
// Export Excel file (optional)
workbook.easy_WriteXLSXFile("C:\\Samples\\Excel calculation.xlsx");
' Create an instance of the class that creates Excel filesDim workbook As New ExcelDocument
' Add a sheetDim xlsWorksheet = New ExcelWorksheet("Formula calculation")
workbook.easy_addWorksheet(xlsWorksheet)
' Get the table of data for the sheetDim xlsTable = xlsWorksheet.easy_getExcelTable()
' Add data in cells and set the formula
xlsTable.easy_getCell("A1").setValue("1")
xlsTable.easy_getCell("A2").setValue("2")
xlsTable.easy_getCell("A3").setValue("3")
xlsTable.easy_getCell("A4").setValue("4")
xlsTable.easy_getCell("A6").setValue("=SUM(A1:A4)")
' Call the method that computes Excel formulasDim sError As String = xlsWorksheet.easy_computeFormulas(workbook, True)
If (sError.Equals("")) Then
Console.WriteLine(vbCrLf & "Formulas computed successfully")
Else
Console.WriteLine(vbCrLf & "Error computing formulas! Error: " & sError)
End If' Read formula result
Console.WriteLine("The result of the formula entered at position A6 is: " _
& xlsTable.easy_getCell(5, 0).getFormulaResultValue())
' Export Excel file (optional)
workbook.easy_WriteXLSXFile("C:\Samples\Excel calculation.xlsx")
C++// Create an instance of the class that creates Excel files
EasyXLS::IExcelDocumentPtr workbook;
hr = CoCreateInstance(__uuidof(EasyXLS::ExcelDocument),
NULL,
CLSCTX_ALL,
__uuidof(EasyXLS::IExcelDocument),
(void**) &workbook) ;
// Add a sheet
EasyXLS::IExcelWorksheetPtr xlsWorksheet;
hr = CoCreateInstance(__uuidof(EasyXLS::ExcelWorksheet),
NULL,
CLSCTX_ALL,
__uuidof(EasyXLS::IExcelWorksheet),
(void**) &xlsWorksheet) ;
xlsWorksheet->setSheetName("Formula calculation");
workbook->easy_addWorksheet(xlsWorksheet);
// Get the table of data for the sheet
EasyXLS::IExcelTablePtr xlsTable = xlsWorksheet->easy_getExcelTable();
// Add data in cells and set the formula
xlsTable->easy_getCell_2("A1")->setValue("1");
xlsTable->easy_getCell_2("A2")->setValue("2");
xlsTable->easy_getCell_2("A3")->setValue("3");
xlsTable->easy_getCell_2("A4")->setValue("4");
xlsTable->easy_getCell_2("A6")->setValue("=SUM(A1:A4)");
// Call the method that computes Excel formulas
_bstr_t sError =
xlsWorksheet->easy_computeFormulas(_variant_t((IDispatch*)workbook, true), true);
if (strcmp(sError, "") == 0)
printf("\nFormulas computed successfully");
else
printf("\nError computing formulas! Error: ", sError);
// Read formula result
printf("\nThe result of the formula entered at position A6 is: %s",
(LPCSTR)xlsTable->easy_getCell(5,0)->getFormulaResultValue());
// Export Excel file (optional)
workbook->easy_WriteXLSXFile("C:\\Samples\\Excel calculation.xlsx");
C++.NET// Create an instance of the class that creates Excel files
ExcelDocument ^workbook = gcnew ExcelDocument();
// Add a sheet
ExcelWorksheet ^xlsWorksheet = gcnew ExcelWorksheet("Formula calculation");
workbook->easy_addWorksheet(xlsWorksheet);
// Get the table of data for the sheet
ExcelTable ^xlsTable = xlsWorksheet->easy_getExcelTable();
// Add data in cells and set the formula
xlsTable->easy_getCell("A1")->setValue("1");
xlsTable->easy_getCell("A2")->setValue("2");
xlsTable->easy_getCell("A3")->setValue("3");
xlsTable->easy_getCell("A4")->setValue("4");
xlsTable->easy_getCell("A6")->setValue("=SUM(A1:A4)");
// Call the method that computes Excel formulas
String ^sError = xlsWorksheet->easy_computeFormulas(workbook, true);
if (sError->Equals(""))
Console::WriteLine("Formulas computed successfully");
else
Console::WriteLine(String::Concat("Error computing formulas! Error: ", sError));
// Read formula result
Console::WriteLine(String::Concat(
"The result of the formula entered at position A6 is: ",
xlsTable->easy_getCell(5,0)->getFormulaResultValue()));
// Export Excel file (optional)
workbook->easy_WriteXLSXFile("C:\\Samples\\Excel calculation.xlsx");
// Create an instance of the class that creates Excel files
ExcelDocument workbook = new ExcelDocument();
// Add a sheet
ExcelWorksheet xlsWorksheet = new ExcelWorksheet("Formula calculation");
workbook.easy_addWorksheet(xlsWorksheet);
// Get the table of data for the sheet
ExcelTable xlsTable = xlsWorksheet.easy_getExcelTable();
// Add data in cells and set the formula
xlsTable.easy_getCell("A1").setValue("1");
xlsTable.easy_getCell("A2").setValue("2");
xlsTable.easy_getCell("A3").setValue("3");
xlsTable.easy_getCell("A4").setValue("4");
xlsTable.easy_getCell("A6").setValue("=SUM(A1:A4)");
// Call the method that computes Excel formulas
String sError = xlsWorksheet.easy_computeFormulas(workbook, true);
if (sError.Length == 0)
Console.WriteLine("Formulas computed successfully");
else
Console.WriteLine("Error computing formulas! Error: " + sError);
// Read formula result
Console.WriteLine("The result of the formula entered at position A6 is: " +
xlsTable.easy_getCell(5,0).getFormulaResultValue());
// Export Excel file (optional)
workbook.easy_WriteXLSXFile("C:\\Samples\\Excel calculation.xlsx");
// Create an instance of the class that creates Excel files
$workbook = new COM("EasyXLS.ExcelDocument");
// Add a sheet
$xlsWorksheet = new COM("EasyXLS.ExcelWorksheet");
$xlsWorksheet->setSheetName("Formula calculation");
$workbook->easy_addWorksheet($xlsWorksheet);
// Get the table of data for the sheet
$xlsTable = $xlsWorksheet->easy_getExcelTable();
// Add data in cells and set the formula
$xlsTable->easy_getCell_2("A1")->setValue("1");
$xlsTable->easy_getCell_2("A2")->setValue("2");
$xlsTable->easy_getCell_2("A3")->setValue("3");
$xlsTable->easy_getCell_2("A4")->setValue("4");
$xlsTable->easy_getCell_2("A6")->setValue("=SUM(A1:A4)");
// Call the method that computes Excel formulas
$sError = $xlsWorksheet->easy_computeFormulas($workbook, true);
if ($sError == "")
echo"Formulas computed successfully <br />";
elseecho"Error computing formulas! Error: " . $sError;
// Read formula resultecho"The result of the formula entered at position A6 is: " .
$xlsTable->easy_getCell(5,0)->getFormulaResultValue();
// Export excel file (optional)
$workbook->easy_WriteXLSXFile("C:\Samples\Excel calculation.xlsx");
' Create an instance of the class that creates Excel filesset workbook = Server.CreateObject("EasyXLS.ExcelDocument")
' Add a sheetset xlsWorksheet = Server.CreateObject("EasyXLS.ExcelWorksheet")
xlsWorksheet.setSheetName("Formula calculation")
workbook.easy_addWorksheet(xlsWorksheet)
' Get the table of data for the sheetset xlsTable = xlsWorksheet.easy_getExcelTable()
' Add data in cells and set the formula
xlsTable.easy_getCell_2("A1").setValue("1")
xlsTable.easy_getCell_2("A2").setValue("2")
xlsTable.easy_getCell_2("A3").setValue("3")
xlsTable.easy_getCell_2("A4").setValue("4")
xlsTable.easy_getCell_2("A6").setValue("=SUM(A1:A4)")
' Call the method that computes Excel formulas
sError = xlsWorksheet.easy_computeFormulas(workbook, true)
if sError = ""then
response.write("Formulas computed successfully <br />")
else
response.write("Error computing formulas! Error: " + sError)
end if' Read formula result
response.write("The result of the formula entered at position A6 is: " + _
xlsTable.easy_getCell(5,0).getFormulaResultValue())
' Export Excel file (optional)
workbook.easy_WriteXLSXFile ("C:\Samples\Excel calculation.xlsx")
' Create an instance of the class that creates Excel filesSet workbook = CreateObject("EasyXLS.ExcelDocument")
' Add a sheetSet xlsWorksheet = CreateObject("EasyXLS.ExcelWorksheet")
xlsWorksheet.setSheetName ("Formula calculation")
workbook.easy_addWorksheet (xlsWorksheet)
' Get the table of data for the sheetSet xlsTable = xlsWorksheet.easy_getExcelTable()
' Add data in cells and set the formula
xlsTable.easy_getCell_2("A1").setValue ("1")
xlsTable.easy_getCell_2("A2").setValue ("2")
xlsTable.easy_getCell_2("A3").setValue ("3")
xlsTable.easy_getCell_2("A4").setValue ("4")
xlsTable.easy_getCell_2("A6").setValue ("=SUM(A1:A4)")
' Call the method that computes Excel formulas
sError = xlsWorksheet.easy_computeFormulas(workbook, True)
If sError = ""Then
Me.Label1.Caption = Me.Label1.Caption & vbCrLf & "Formulas computed successfully"Else
Me.Label1.Caption = Me.Label1.Caption & vbCrLf & _
"Error computing formulas! Error: " & sError
End If' Read formula result
Me.Label1.Caption = Me.Label1.Caption & vbCrLf & _
"The result of the formula entered at position A6 is: " & _
xlsTable.easy_getCell(5, 0).getFormulaResultValue()
' Export Excel file (optional)
workbook.easy_WriteXLSXFile ("C:\Samples\Excel calculation.xlsx")
' Create an instance of the class that creates Excel filesSet workbook = CreateObject("EasyXLS.ExcelDocument")
' Add a sheetSet xlsWorksheet = CreateObject("EasyXLS.ExcelWorksheet")
xlsWorksheet.setSheetName ("Formula calculation")
workbook.easy_addWorksheet (xlsWorksheet)
' Get the table of data for the sheetSet xlsTable = xlsWorksheet.easy_getExcelTable()
' Add data in cells and set the formula
xlsTable.easy_getCell_2("A1").setValue ("1")
xlsTable.easy_getCell_2("A2").setValue ("2")
xlsTable.easy_getCell_2("A3").setValue ("3")
xlsTable.easy_getCell_2("A4").setValue ("4")
xlsTable.easy_getCell_2("A6").setValue ("=SUM(A1:A4)")
' Call the method that computes Excel formulas
sError = xlsWorksheet.easy_computeFormulas(workbook, True)
If sError = ""Then
WScript.StdOut.Write(vbcrlf & "Formulas computed successfully")
Else
WScript.StdOut.Write(vbcrlf & "Error computing formulas! Error: " & sError)
End If' Read formula result
WScript.StdOut.Write(vbcrlf & "The result of the formula entered at position A6 is: " _
& xlsTable.easy_getCell(5, 0).getFormulaResultValue())
' Export Excel file (optional)
workbook.easy_WriteXLSXFile ("C:\Samples\Excel calculation.xlsx")
<!-- Create an instance of the class that creates Excel files --><cfobject type="java"class="EasyXLS.ExcelDocument"name="workbook"action="CREATE"><!-- Add a sheet --><cfobject type="java"class="EasyXLS.ExcelWorksheet"name="xlsWorksheet"action="CREATE"><cfset xlsWorksheet.setSheetName("Formula calculation")><cfset workbook.easy_addWorksheet(xlsWorksheet)><!-- Get the table of data for the sheet --><cfset xlsTable = xlsWorksheet.easy_getExcelTable()><!-- Add data in cells and set the formula --><cfset xlsTable.easy_getCell("A1").setValue("1")><cfset xlsTable.easy_getCell("A2").setValue("2")><cfset xlsTable.easy_getCell("A3").setValue("3")><cfset xlsTable.easy_getCell("A4").setValue("4")><cfset xlsTable.easy_getCell("A6").setValue("=SUM(A1:A4)")><!-- Call the method that computes Excel formulas --><cfset sError = xlsWorksheet.easy_computeFormulas(workbook, true)><CFIF (sError IS "")><cfoutput>
Formulas computed successfully <br />
</cfoutput>
<CFELSE>
<cfoutput>
Error computing formulas! Error: #sError#
</cfoutput>
</CFIF><!-- Read formula result --><cfoutput>
The result of the formula entered at position A6 is:
#xlsTable.easy_getCell(5,0).getFormulaResultValue()#
</cfoutput><!-- Export Excel file (optional) --><cfset ret = workbook.easy_WriteXLSXFile("C:\Samples\Excel calculation.xlsx")>
.NET:# Create an instance of the class that creates Excel files
workbook = ExcelDocument()
# Add a sheet
xlsWorksheet = ExcelWorksheet("Formula calculation")
workbook.easy_addWorksheet(xlsWorksheet)
# Get the table of data for the sheet
xlsTable = xlsWorksheet.easy_getExcelTable()
# Add data in cells and set the formula
xlsTable.easy_getCell("A1").setValue("1")
xlsTable.easy_getCell("A2").setValue("2")
xlsTable.easy_getCell("A3").setValue("3")
xlsTable.easy_getCell("A4").setValue("4")
xlsTable.easy_getCell("A6").setValue("=SUM(A1:A4)")
# Call the method that computes Excel formulas
sError = xlsWorksheet.easy_computeFormulas(workbook, True)
if len(sError) == 0:
print("Formulas computed successfully")
else:
print("Error computing formulas! Error: " + sError)
# Read formula result
print("The result of the formula entered at position A6 is: " +
xlsTable.easy_getCell(5,0).getFormulaResultValue())
# Export Excel file (optional)
workbook.easy_WriteXLSXFile("C:\\Samples\\Excel calculation.xlsx")
Java:# Create an instance of the class that creates Excel files
workbook = gateway.jvm.ExcelDocument()
# Add a sheet
xlsWorksheet = gateway.jvm.ExcelWorksheet("Formula calculation")
workbook.easy_addWorksheet(xlsWorksheet)
# Get the table of data for the sheet
xlsTable = xlsWorksheet.easy_getExcelTable()
# Add data in cells and set the formula
xlsTable.easy_getCell("A1").setValue("1")
xlsTable.easy_getCell("A2").setValue("2")
xlsTable.easy_getCell("A3").setValue("3")
xlsTable.easy_getCell("A4").setValue("4")
xlsTable.easy_getCell("A6").setValue("=SUM(A1:A4)")
# Call the method that computes Excel formulas
sError = xlsWorksheet.easy_computeFormulas(workbook, True)
if len(sError) == 0:
print("Formulas computed successfully")
else:
print("Error computing formulas! Error: " + sError)
# Read formula result
print("The result of the formula entered at position A6 is: " +
xlsTable.easy_getCell(5,0).getFormulaResultValue())
# Export Excel file (optional)
workbook.easy_WriteXLSXFile("C:\\Samples\\Excel calculation.xlsx")
Excel functions
The calculation engine provides all the functions supported by Excel. The full list of formulas elements can be found at the following link.
EasyXLS allows you to import an Excel file as a template with predefined formulas with functions, calculate spreadsheet formulas and read the formula result.
