Update v2.3.0

Author: rabanti-github

Changelog.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## v2.3.0
+---
+Release Date: **09.02.2018**
+
+- Added most important formulas as static method calls in the sub-class Cell.BasicFormulas (round, floor, ceil, min, max, average, median, sum, vlookup)
+- Removed overloaded methods to add cells as type Cell. This can be done now with the overloading of the type object (no code changes necessary)
+- Added new constructors for Address and Range
+- Added demo for the new static formula methods
+- Fixed a bug that kept the stream of the saved file open as long as the program was running 
+- Minor bug fixes
+- Documentation update
+
 ## v2.2.0
 ---
 Release Date: **10.12.2017**

Demo/Program.cs

@@ -32,6 +32,7 @@ static void Main(string[] args)
             Demo6();
             Demo7();
             Demo8();
+            Demo9();
 
             /* ### PERFORMANCE TESTS ### */
             // # Use tests in this section to test the performance of PicoXLSX
@@ -306,5 +307,69 @@ private static void Demo8()
             workbook.Save();                                            								// Save the workbook
         }
 
+        /// <summary>
+        /// This demo shows the usage of basic Excel formulas
+        /// </summary>
+        private static void Demo9()
+        {
+            Workbook workbook = new Workbook("test9.xlsx", "sheet1");                                   // Create a new workbook 
+            List<object> numbers = new List<object> {1.15d, 2.225d, 13.8d, 15d, 15.1d, 17.22d, 22d, 107.5d, 128d }; // Create a list of numbers
+            List<object> texts = new List<object>() { "value 1", "value 2", "value 3", "value 4", "value 5", "value 6", "value 7", "value 8", "value 9" }; // Create a list of strings (for vlookup)
+            workbook.WS.Value("Numbers", Style.BasicStyles.Bold);                                       // Add a header with a basic style
+            workbook.WS.Value("Values", Style.BasicStyles.Bold);                                        // Add a header with a basic style
+            workbook.WS.Value("Formula type", Style.BasicStyles.Bold);                                  // Add a header with a basic style
+            workbook.WS.Value("Formula value", Style.BasicStyles.Bold);                                 // Add a header with a basic style
+            workbook.WS.Value("(See also worksheet2)");                                                 // Add a note
+            workbook.CurrentWorksheet.AddCellRange(numbers, "A2:A10");                                  // Add the numbers as range
+            workbook.CurrentWorksheet.AddCellRange(texts, "B2:B10");                                    // Add the values as range
+
+            workbook.CurrentWorksheet.SetCurrentCellAddress("D2");                                      // Set the "cursor" to D2
+            Cell c;                                                                                     // Create an empty cell object (reusable)
+            c = Cell.BasicFormulas.Average(new Cell.Range("A2:A10"));                                   // Define an average formula
+            workbook.CurrentWorksheet.AddCell("Average", "C2");                                         // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D2");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Ceil(new Cell.Address("A2"), 0);                                     // Define a ceil formula
+            workbook.CurrentWorksheet.AddCell("Ceil", "C3");                                           // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D3");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Floor(new Cell.Address("A2"), 0);                                    // Define a floor formula
+            workbook.CurrentWorksheet.AddCell("Floor", "C4");                                           // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D4");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Round(new Cell.Address("A3"), 1);                                    // Define a round formula with one digit after the comma
+            workbook.CurrentWorksheet.AddCell("Round", "C5");                                           // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D5");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Max(new Cell.Range("A2:A10"));                                       // Define a max formula
+            workbook.CurrentWorksheet.AddCell("Max", "C6");                                             // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D6");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Min(new Cell.Range("A2:A10"));                                       // Define a min formula
+            workbook.CurrentWorksheet.AddCell("Min", "C7");                                             // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D7");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Median(new Cell.Range("A2:A10"));                                    // Define a median formula
+            workbook.CurrentWorksheet.AddCell("Median", "C8");                                          // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D8");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Sum(new Cell.Range("A2:A10"));                                       // Define a sum formula
+            workbook.CurrentWorksheet.AddCell("Sum", "C9");                                             // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D9");                                                 // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.VLookup(13.8d, new Cell.Range("A2:B10"), 2, true);                   // Define a vlookup formula (look for the value of the number 13.8) 
+            workbook.CurrentWorksheet.AddCell("Vlookup", "C10");                                        // Add the description of the formula to the worksheet
+            workbook.CurrentWorksheet.AddCell(c, "D10");                                                // Add the formula to the worksheet
+
+            workbook.AddWorksheet("sheet2");                                                            // Create a new worksheet
+            c = Cell.BasicFormulas.VLookup(workbook.Worksheets[0], new Cell.Address("B4"), workbook.Worksheets[0], new Cell.Range("B2:C10"), 2, true); // Define a vlookup formula in worksheet1 (look for the text right of the (value of) cell B4) 
+            workbook.WS.Value(c);                                                                       // Add the formula to the worksheet
+
+            c = Cell.BasicFormulas.Median(workbook.Worksheets[0], new Cell.Range("A2:A10"));            // Define a median formula in worksheet1
+            workbook.WS.Value(c);                                                                       // Add the formula to the worksheet
+
+            workbook.Save();                                                                            // Save the workbook
+        }
+
     }
-}
+}