Add support for multi-dimensional arrays

src/Serilog/Capturing/PropertyValueConverter.cs

@@ -214,6 +214,40 @@ bool TryConvertEnumerable(object value, Type type, Destructuring destructuring,
                 {
                     result = SequenceValue.Empty;
                 }
+                else if (list is Array a && a.Rank > 1)
+                {
+                    var rows = new LogEventPropertyValue[a.GetLength(0)];
+                    if (a.Rank == 2)
+                    {
+                        for (int i = 0; i < rows.Length; ++i)
+                        {
+                            var columns = new LogEventPropertyValue[a.GetLength(1)];
+                            for (int j = 0; j < columns.Length; ++j)
+                                columns[j] = _depthLimiter.CreatePropertyValue(a.GetValue(i, j), destructuring);
+                            rows[i] = new SequenceValue(columns);
+                        }
+                    }
+                    else if (a.Rank == 3)
+                    {
+                        for (int i = 0; i < rows.Length; ++i)
+                        {
+                            var columns = new LogEventPropertyValue[a.GetLength(1)];
+                            for (int j = 0; j < columns.Length; ++j)
+                            {
+                                var heights = new LogEventPropertyValue[a.GetLength(2)];
+                                for (int k = 0; k < heights.Length; ++k)
+                                    heights[k] = _depthLimiter.CreatePropertyValue(a.GetValue(i, j, k), destructuring);
+                                columns[j] = new SequenceValue(heights);
+                            }
+                            rows[i] = new SequenceValue(columns);
+                        }
+                    }
+                    else
+                    {
+                        throw new NotSupportedException("Serilog does not support multi-dimensional arrays with Rank > 3.");
+                    }
+                    result = new SequenceValue(rows);
+                }
                 else
                 {
                     var array = new LogEventPropertyValue[list.Count];

test/Serilog.Tests/Core/LoggerTests.cs

@@ -317,6 +317,54 @@ public void NullMessageTemplateParametersDoNotBreakBinding()
         // ReSharper restore StructuredMessageTemplateProblem
     }
 
+    // https://github.com/serilog/serilog/issues/2019
+    [Fact]
+    public void Two_Dimensional_Array_Should_Be_Logger_As_Sequence()
+    {
+        var evt = DelegatingSink.GetLogEvent(l =>
+        {
+            var a = new object[3, 2] { { "a", "b" }, { "c", "d" }, { "e", "f" } };
+            l.Error("{@Value}", a);
+        });
+
+        Assert.Equal(1, evt.Properties.Count);
+        var arr = (SequenceValue)evt.Properties["Value"];
+        Assert.Equal(3, arr.Elements.Count);
+        Assert.Equal("[[a,b],[c,d],[e,f]]", arr.LiteralValue());
+    }
+
+    // https://github.com/serilog/serilog/issues/2019
+    [Fact]
+    public void Three_Dimensional_Array_Should_Be_Logger_As_Sequence()
+    {
+        var evt = DelegatingSink.GetLogEvent(l =>
+        {
+            var a = new object[3, 2, 1] { { { "a" }, { "b" } }, { { "c" }, { "d" } }, { { "e" }, { "f" } } };
+            l.Error("{@Value}", a);
+        });
+
+        Assert.Equal(1, evt.Properties.Count);
+        var arr = (SequenceValue)evt.Properties["Value"];
+        Assert.Equal(3, arr.Elements.Count);
+        Assert.Equal("[[[a],[b]],[[c],[d]],[[e],[f]]]", arr.LiteralValue());
+    }
+
+
+    // https://github.com/serilog/serilog/issues/2019
+    [Fact]
+    public void Four_Dimensional_Array_Not_Supported()
+    {
+        var evt = DelegatingSink.GetLogEvent(l =>
+        {
+            var a = new object[4, 3, 2, 1];
+            l.Error("{@Value}", a);
+        });
+
+        Assert.Equal(1, evt.Properties.Count);
+        var val = evt.Properties["Value"].LiteralValue();
+        Assert.Equal("Capturing the property value threw an exception: NotSupportedException", val);
+    }
+
 #if FEATURE_ASYNCDISPOSABLE
 
     [Fact]

test/Serilog.Tests/Serilog.Tests.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <!-- Tests target .NET Framework 4.6.2 plus the latest RTM of .NET Framework -->
     <TargetFrameworks Condition=" '$(OS)' == 'Windows_NT'">net462;net48</TargetFrameworks>

test/Serilog.Tests/Support/Extensions.cs

@@ -4,6 +4,11 @@ public static class Extensions
 {
     public static object? LiteralValue(this LogEventPropertyValue @this)
     {
-        return ((ScalarValue)@this).Value;
+        if (@this is ScalarValue scalar)
+            return scalar.Value;
+        else if (@this is SequenceValue sequence)
+            return $"[{string.Join(",", sequence.Elements.Select(e => e.LiteralValue()))}]";
+        else
+            throw new NotSupportedException(@this.GetType().Name);
     }
 }