Merge branch 'dev'

Author: rabanti-github

Changelog.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## v2.6.0
+
+---
+Release Date: **19.08.2018**
+
+- Added asynchronous methods SaveAsync, SaveAsAsync and SaveAsStreamAsync
+- Added a new constructor in the Cell class with the address as string
+- Added a new example for the introduced async methods
+- Minor bug fixes and optimizations
+- Fixed typos
+
+
 ## v2.5.1
 
 ---
@@ -15,7 +27,7 @@ Release Date: **19.08.2018**
 Release Date: **02.07.2018**
 
 - Added address types (no fixed rows and columns, fixed rows, fixed columns, fixed rows and columns; Useful in formulas)
-- Added new CellDirection Disabled, if the addresses of the cells are defined manually (AddNextCell will override the current cell in this case)
+- Added new option CellDirection Disabled, if the addresses of the cells are defined manually (AddNextCell will override the current cell in this case)
 - Altered Demo 3 to demonstrate disabling of automatic cell addressing
 - Extended Demo 1 to demonstrate the new address types
 - Minor, internal changes

Demo/Program.cs

@@ -8,6 +8,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Threading.Tasks;
 using PicoXLSX;
 
 
@@ -25,6 +26,7 @@ static void Main(string[] args)
             BasicDemo();
             ShortenerDemo();
             StreamDemo();
+            AsyncDemo(); // Normally, this method should be called with the await keyword (what is not possible here). Usually, async methods are called along the call stack with await until a terminal element (like a WPF button) is reached
             Demo1();
             Demo2();
             Demo3();
@@ -93,6 +95,17 @@ private static void StreamDemo()
             workbook.SaveAsStream(fs);                                      // Save the workbook into the stream
         }
 
+        /// <summary>
+        /// This method shows how to save a workbook asynchronous
+        /// </summary>
+        private static async Task AsyncDemo()
+        {
+            Workbook workbook = new Workbook("shhet1", "async.xlsx");       // Create new workbook with file name
+            workbook.WS.Value("Some text");                                 // Add cell A1
+            workbook.WS.Value(222);                                         // Add cell B1
+            workbook.WS.Formula("=A2");                                     // Add cell C1
+            await workbook.SaveAsync();                                     // Save async
+        }
 
         /// <summary>
         /// This method shows the usage of AddNextCell with several data types and formulas. Furthermore, the several types of Addresses are demonstrated
@@ -297,8 +310,8 @@ private static void Demo6()
         private static void Demo7()
         {
             Workbook workbook = new Workbook(false);                                                    // Create new workbook without worksheet
-            String invalidSheetName = "Sheet?1";                                                        // ? is not allowed in the names of worksheets
-            String sanitizedSheetName = Worksheet.SanitizeWorksheetName(invalidSheetName, workbook);    // Method to sanitize a worksheet name (replaces ? with _)
+            string invalidSheetName = "Sheet?1";                                                        // ? is not allowed in the names of worksheets
+            string sanitizedSheetName = Worksheet.SanitizeWorksheetName(invalidSheetName, workbook);    // Method to sanitize a worksheet name (replaces ? with _)
             workbook.AddWorksheet(sanitizedSheetName);                                                  // Add new worksheet
             Worksheet ws = workbook.CurrentWorksheet;                                                   // Create reference (shortening)
             List<object> values = new List<object>() { "Cell A1", "Cell B1", "Cell C1", "Cell D1" };    // Create a List of values

Demo/Testing/Performance.cs

@@ -19,7 +19,7 @@ namespace Testing
     public class Performance
     {
         /// <summary>
-        /// Method to perform a stress test on PixoXLSX with a high amount of random data
+        /// Method to perform a stress test on PicoXLSX with a high amount of random data
         /// </summary>
         /// <param name="filename">filename of the output</param>
         /// <param name="sheetname">name of the worksheet</param>

Documentation/CodeDocumentation.shfbproj

@@ -62,10 +62,20 @@ PicoXLSX was created with .NET version 4.5. Newer versions like 4.6.1 are workin
 If you want to compile the documentation project %28folder: Documentation%3b project file: shfbproj%29, you need also the &lt%3bstrong&gt%3b&lt%3ba href=&quot%3bhttps://github.com/EWSoftware/SHFB&quot%3b&gt%3bSandcastle Help File Builder %28SHFB%29&lt%3b/a&gt%3b&lt%3b/strong&gt%3b. It is also freely available. But you don’t need the documentation project to build the PicoXLSX library.
 &lt%3bbr/&gt%3b
 &lt%3bh2&gt%3bInstallation&lt%3b/h2&gt%3b
+
+&lt%3bh3&gt%3bUsing NuGet&lt%3b/h3&gt%3b
+
+By Package Manager:&lt%3bbr&gt%3b
+&lt%3bpre&gt%3b&lt%3bcode&gt%3bInstall-Package PicoXLSX&lt%3b/code&gt%3b&lt%3b/pre&gt%3b
+&lt%3bbr&gt%3b
+&lt%3bbr&gt%3b
+By .NET CLI:&lt%3bbr&gt%3b
+&lt%3bpre&gt%3b&lt%3bcode&gt%3bdotnet add package PicoXLSX&lt%3b/code&gt%3b&lt%3b/pre&gt%3b
 
 &lt%3bh3&gt%3bAs DLL&lt%3b/h3&gt%3b
 
 Simply place the PicoXLSX DLL into your .NET project and add a reference to it. Please keep in mind that the .NET version of your solution must match with the runtime version of the PicoXLSX DLL %28currently compiled with 4.5%29.
+
 &lt%3bh3&gt%3bAs source files&lt%3b/h3&gt%3b
 
 Place all .CS files from the PicoXLSX source folder into your project. You can place them into a sub-folder if you wish. The files contains definitions for workbooks, worksheets, cells, styles, meta-data, low level methods and exceptions.

Executable/Debug/PicoXLSX.XML

@@ -161,6 +161,24 @@ public Cell(object value, CellType type)
             }
         }
 
+        /// <summary>
+        /// Constructor with value, cell type and address. The worksheet reference is set to null and must be assigned later
+        /// </summary>
+        /// <param name="value">Value of the cell</param>
+        /// <param name="type">Type of the cell</param>
+        /// <param name="address">Address of the cell</param>
+        public Cell(Object value, CellType type, string address)
+        {
+            this.DataType = type;
+            this.Value = value;
+            this.CellAddress = address;
+            this.WorksheetReference = null;
+            if (type == CellType.DEFAULT)
+            {
+                ResolveCellType();
+            }
+        }
+
         /// <summary>
         /// Constructor with value, cell type, row number, column number and the link to a worksheet
         /// </summary>