Add new function: AddTable

- Update unit test

Author: xuri

Excelize.Tests/UnitTest.cs

@@ -789,10 +789,61 @@ public void TestPivotTable()
     public void TestAddSlicer()
     {
         File f = Excelize.NewFile();
+        Assert.Null(
+            Record.Exception(() =>
+            {
+                f.NewSheet("Sheet2");
+                f.AddTable("Sheet1", new Table { Name = "Table1", Range = "A1:D5" });
+                f.AddTable(
+                    "Sheet2",
+                    new Table
+                    {
+                        Range = "F2:H6",
+                        Name = "table",
+                        StyleName = "TableStyleMedium2",
+                        ShowFirstColumn = true,
+                        ShowLastColumn = true,
+                        ShowRowStripes = false,
+                        ShowColumnStripes = true,
+                    }
+                );
+                f.AddSlicer(
+                    "Sheet1",
+                    new SlicerOptions
+                    {
+                        Name = "Column1",
+                        Cell = "E1",
+                        TableSheet = "Sheet1",
+                        TableName = "Table1",
+                        Caption = "Column1",
+                    }
+                );
+                f.AddSlicer(
+                    "Sheet1",
+                    new SlicerOptions
+                    {
+                        Name = "Column1",
+                        Cell = "I1",
+                        TableSheet = "Sheet2",
+                        TableName = "table",
+                        Caption = "Column1",
+                    }
+                );
+            })
+        );
         RuntimeError err = Assert.Throws<RuntimeError>(() =>
             f.AddSlicer("Sheet1", new SlicerOptions { })
         );
         Assert.Equal("parameter is invalid", err.Message);
+        err = Assert.Throws<RuntimeError>(() => f.AddTable("Sheet1", new Table { }));
+        Assert.Equal("parameter is invalid", err.Message);
+        Assert.Null(
+            Record.Exception(() =>
+            {
+                f.SaveAs("TestAddSlicer.xlsx");
+            })
+        );
+        Assert.Empty(f.Close());
     }
 
     [Fact]

Excelize/Excelize.cs

@@ -156,6 +156,13 @@ internal static extern IntPtr AddSparkline(
             ref TypesC.SparklineOptions opts
         );
 
+        [DllImport(LibraryName, CallingConvention = CallingConvention.Cdecl)]
+        internal static extern IntPtr AddTable(
+            long fileIdx,
+            [MarshalAs(UnmanagedType.LPUTF8Str)] string sheet,
+            ref TypesC.Table opts
+        );
+
         [DllImport(LibraryName, CallingConvention = CallingConvention.Cdecl)]
         internal static extern IntPtr AddVBAProject(long fileIdx, byte[] b, int bLen);
 
@@ -2109,6 +2116,61 @@ public void AddSparkline(string sheet, SparklineOptions options)
                 throw new RuntimeError(err);
         }
 
+        /// <summary>
+        /// Adds a table to a worksheet using the specified worksheet name,
+        /// range reference, and format settings.
+        /// <example>
+        /// Create a table on Sheet1 for the range A1:D5:
+        /// <code>
+        /// f.AddTable("Sheet1", new Table { Range = "A1:D5" });
+        /// </code>
+        /// Create a table on Sheet2 for the range F2:H6 with formatting:
+        /// <code>
+        /// f.AddTable(
+        ///     "Sheet2",
+        ///     new Table
+        ///     {
+        ///         Range = "F2:H6",
+        ///         Name = "table",
+        ///         StyleName = "TableStyleMedium2",
+        ///         ShowFirstColumn = true,
+        ///         ShowLastColumn = true,
+        ///         ShowRowStripes = false,
+        ///         ShowColumnStripes = true,
+        ///     }
+        /// );
+        /// </code>
+        /// </example>
+        /// </summary>
+        /// <remarks>
+        /// The table must include at least two rows, including a header row.
+        /// Header cells must contain unique string values.
+        /// Set the header row data before calling <c>AddTable</c>.
+        /// Table ranges within the same worksheet must not intersect.
+        ///
+        /// <para><b>Name:</b> The name of the table must be unique within the
+        /// worksheet, begin with a letter or underscore, contain no spaces or
+        /// special characters, and be no more than 255 characters long.</para>
+        ///
+        /// <para><b>StyleName:</b> Valid built-in table style names include:</para>
+        /// <list type="bullet">
+        ///   <item><description>TableStyleLight1 – TableStyleLight21</description></item>
+        ///   <item><description>TableStyleMedium1 – TableStyleMedium28</description></item>
+        ///   <item><description>TableStyleDark1 – TableStyleDark11</description></item>
+        /// </list>
+        /// </remarks>
+        /// <param name="sheet">The worksheet name</param>
+        /// <param name="options">The table options</param>
+        /// <exception cref="RuntimeError">Return None if no error occurred,
+        /// otherwise raise a RuntimeError with the message.</exception>
+        public void AddTable(string sheet, Table options)
+        {
+            var opts = (TypesC.Table)Lib.CsToC(options, new TypesC.Table());
+            string err = Marshal.PtrToStringUTF8(Lib.AddTable(FileIdx, sheet, ref opts));
+            if (!string.IsNullOrEmpty(err))
+                throw new RuntimeError(err);
+        }
+
         /// <summary>
         /// Add vbaProject.bin file which contains functions and/or macros. The
         /// file extension should be XLSM or XLTM.

Excelize/TypesC.cs

@@ -605,6 +605,25 @@ public unsafe struct SparklineOptions
         public sbyte* EmptyCells;
     }
 
+    [StructLayout(LayoutKind.Sequential)]
+    public unsafe struct Table
+    {
+        public sbyte* Range;
+        public sbyte* Name;
+        public sbyte* StyleName;
+
+        [MarshalAs(UnmanagedType.I1)]
+        public bool ShowColumnStripes;
+
+        [MarshalAs(UnmanagedType.I1)]
+        public bool ShowFirstColumn;
+        public bool* ShowHeaderRow;
+
+        [MarshalAs(UnmanagedType.I1)]
+        public bool ShowLastColumn;
+        public bool* ShowRowStripes;
+    }
+
     [StructLayout(LayoutKind.Sequential)]
     public unsafe struct StringErrorResult
     {

Excelize/TypesCs.cs

@@ -762,6 +762,21 @@ public struct SparklineOptions
         public string EmptyCells;
     }
 
+    /// <summary>
+    /// Table directly maps the format settings of the table.
+    /// </summary>
+    public struct Table
+    {
+        public string Range;
+        public string Name;
+        public string StyleName;
+        public bool ShowColumnStripes;
+        public bool ShowFirstColumn;
+        public bool? ShowHeaderRow;
+        public bool ShowLastColumn;
+        public bool? ShowRowStripes;
+    }
+
     public struct Row
     {
         public string[]? Cell;