增加测试和文档

Author: netty2019

README.zh-CN.md

@@ -228,6 +228,31 @@
         public Genders Gender { get; set; }
 ```
 
+- **也可以继承“ValueMappingsBaseAttribute”特性基类实现值映射关系，目前仅可用于枚举和Bool类型，支持导入导出。**
+```csharp
+        [AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
+        public class GenderLocalAttribute : ValueMappingsBaseAttribute
+        {
+            public override Dictionary<string, object> GetMappings(PropertyInfo propertyInfo)
+            {
+                var res= new Dictionary<string, object>();
+                res.Add("男",Genders.Male);
+                res.Add("女",Genders.Female);
+                return res;
+            }
+        }
+
+
+        /// <summary>
+        ///     性别
+        /// </summary>
+        [ImporterHeader(Name = "性别")]
+        [Required(ErrorMessage = "性别不能为空")]
+        [GenderLocal]
+        public Genders Gender { get; set; }
+```
+
+
 - **支持枚举和Bool类型的导入数据验证项的生成，以及相关数据转换**
 	- **枚举默认情况下会自动获取枚举的描述、显示名、名称和值生成数据项**
 

src/Magicodes.ExporterAndImporter.Tests/ExcelExporterWithXSSFWorkbook_Tests.cs

@@ -958,8 +958,55 @@ public async Task ValueMapping_Test()
             }
         }
 
-        
-        
+        [Fact(DisplayName = "ValueMappingsBase测试#544")]
+        public async Task ValueMappingsBase_Test()
+        {
+            IExporter exporter = new ExcelExporter();
+            var filePath = GetTestFilePath($"{nameof(ValueMappingsBase_Test)}.xlsx");
+            DeleteFile(filePath);
+            var list = new List<Issue544>()
+            {
+                new Issue544()
+                {
+                    Gender ="男",
+                    IsAlumni = true,
+                    Name ="张三",
+                    IsAlumni2 = true,
+                },
+                new Issue544()
+                {
+                    Gender ="男",
+                    IsAlumni = false,
+                    Name ="张三",
+                    IsAlumni2 = true,
+                },
+                new Issue544()
+                {
+                    Gender ="男",
+                    IsAlumni = null,
+                    Name ="张三",
+                    IsAlumni2 = false,
+                },
+            };
+            var result = await exporter.ExportWithXSSFWorkbook(filePath, list);
+            result.ShouldNotBeNull();
+            File.Exists(filePath).ShouldBeTrue();
+            using (var pck = new ExcelPackage(new FileInfo(filePath)))
+            {
+                pck.Workbook.Worksheets.Count.ShouldBe(1);
+                var sheet = pck.Workbook.Worksheets.First();
+                sheet.Cells["D2"].Text.ShouldBe("是");
+                sheet.Cells["D3"].Text.ShouldBe("是");
+                sheet.Cells["D4"].Text.ShouldBe("否");
+
+                sheet.Cells["C2"].Text.ShouldBe("是");
+                sheet.Cells["C3"].Text.ShouldBe("否");
+                sheet.Cells["C4"].Text.ShouldBe("");
+            }
+        }
+
+
+
         [Fact(DisplayName = "导出日期格式化#331")]
         public async Task DateTimeExport_Test()
         {

src/Magicodes.ExporterAndImporter.Tests/ExcelExporter_Tests.cs

@@ -964,6 +964,55 @@ public async Task ValueMapping_Test()
         }
 
 
+        [Fact(DisplayName = "ValueMappingsBase测试#544")]
+        public async Task ValueMappingsBase_Test()
+        {
+            IExporter exporter = new ExcelExporter();
+            var filePath = GetTestFilePath($"{nameof(ValueMappingsBase_Test)}.xlsx");
+            DeleteFile(filePath);
+            var list = new List<Issue544>()
+            {
+                new Issue544()
+                {
+                    Gender ="男",
+                    IsAlumni = true,
+                    Name ="张三",
+                    IsAlumni2 = true,
+                },
+                new Issue544()
+                {
+                    Gender ="男",
+                    IsAlumni = false,
+                    Name ="张三",
+                    IsAlumni2 = true,
+                },
+                new Issue544()
+                {
+                    Gender ="男",
+                    IsAlumni = null,
+                    Name ="张三",
+                    IsAlumni2 = false,
+                },
+            };
+            var result = await exporter.Export(filePath, list);
+            result.ShouldNotBeNull();
+            File.Exists(filePath).ShouldBeTrue();
+            using (var pck = new ExcelPackage(new FileInfo(filePath)))
+            {
+                pck.Workbook.Worksheets.Count.ShouldBe(1);
+                var sheet = pck.Workbook.Worksheets.First();
+                sheet.Cells["D2"].Text.ShouldBe("是");
+                sheet.Cells["D3"].Text.ShouldBe("是");
+                sheet.Cells["D4"].Text.ShouldBe("否");
+
+                sheet.Cells["C2"].Text.ShouldBe("是");
+                sheet.Cells["C3"].Text.ShouldBe("否");
+                sheet.Cells["C4"].Text.ShouldBe("");
+            }
+        }
+
+
+
 
         [Fact(DisplayName = "导出日期格式化#331")]
         public async Task DateTimeExport_Test()

src/Magicodes.ExporterAndImporter.Tests/Models/Export/Issue544.cs

@@ -0,0 +1,49 @@
+using Magicodes.ExporterAndImporter.Core;
+using Magicodes.ExporterAndImporter.Excel;
+using Magicodes.IE.Core;
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace Magicodes.ExporterAndImporter.Tests.Models.Export
+{
+    [ExcelExporter(Name = "导出结果", TableStyle = OfficeOpenXml.Table.TableStyles.None)]
+    public class Issue544
+    {
+        /// <summary>
+        /// 名称
+        /// </summary>
+        [ExporterHeader(DisplayName = "姓名")]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// 性别
+        /// </summary>
+        [ExporterHeader(DisplayName = "性别")]
+        public string Gender { get; set; }
+
+        /// <summary>
+        /// 是否校友
+        /// </summary>
+        [ExporterHeader(DisplayName = "是否校友")]
+        [BoolLocal337]
+        public bool? IsAlumni { get; set; }
+
+        [ExporterHeader(DisplayName = "是否校友2")]
+        [BoolLocal337]
+        public bool IsAlumni2 { get; set; }
+    }
+
+
+    [AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
+    public class BoolLocal337Attribute : ValueMappingsBaseAttribute
+    {
+        public override Dictionary<string, object> GetMappings(PropertyInfo propertyInfo)
+        {
+            var res= new Dictionary<string, object>();
+            res.Add("是",true);
+            res.Add("否",false);
+            return res;
+        }
+    }
+}