一个Excel导出类的实现过程（二）：显示定制

导出操作中，我们常常不需要显示所有属性，比如Person类加入Guid属性：

public class Person
{
    public Int32 ID { get; set; }
    public Guid Guid { get; set; }
    public String Name { get; set; }
    public DateTime Birth { get; set; }
    public Double Salary { get; set; }
}

现在要求传入字符串数组headers，有什么显示什么，Type. GetProperty()方法可以取单个属性，我们加入Export的重载方法如下：

static void Export<T>(IList<T> records, IList<String> headers)
{
    if (records == null)
        throw new ArgumentNullException("records");
    if (headers == null || headers.Count == 0)
        throw new ArgumentNullException("headers");
    //像headers不可包含null元素、至少包含一个元素、元素不可重复等检查视需求而定, 下文不重重复

    PropertyInfo[] props = new PropertyInfo[headers.Count];
    for (Int32 i = 0; i < headers.Count; i++)
    {
        props[i] = typeof(T).GetProperty(headers[i]); //注意可能产生为null的元素
    }

    for (Int32 i = 0; i < headers.Count; i++)
    {
        Console.Write(headers[i]);
        Console.Write("\t");
    }
    Console.WriteLine();

    foreach (var record in records)
    {
        for (Int32 i = 0; i < props.Length; i++)
        {
            if (props[i] != null) //注意null检查
            {
                Object value = props[i].GetValue(record, null);
                Console.Write(value);
                Console.Write("\t");
            }
        }
        Console.WriteLine();
    }
}

第一个方法重构如下：

static void Export<T>(IList<T> records)
{
    if (records == null)
        throw new ArgumentNullException("records");

    String[] headers = typeof(T).GetProperties().Select(p => p.Name).ToArray();
    Export<T>(records, headers);
}

现在的导出操作，我们只打印提供的属性数组，同时请注意：小写的“birth”匹配不到任何属性。

Export<Person>(persons, new[] { "Name", "birth", "Salary" });

继续加入业务场景，以上代码使用了属性名，我们可以更友好，比如将“Name”打印为“名称”，“Salary”打印成“薪水”——题外话，好像没啥场景需要打印薪水，Whatever. 加一个辅助的Header类如下，并添加Export重载：

public class Header
{
    public String Name { get; private set; }
    public String PrintName { get; private set; }

    public Header(String name)
        : this(name, name)
    {
    }

    public Header(String name, String printName)
    {
        Name = name;
        PrintName = printName;
    }
}

新的Export方法第2个重载与第3个重载分别为:

static void Export<T>(IList<T> records, IList<String> headers)
{
    if (records == null)
        throw new ArgumentNullException("records");
    if (headers == null || headers.Count == 0)
        throw new ArgumentNullException("headers");

    Header[] newHeaders = typeof(T).GetProperties().Select(p => new Header(p.Name)).ToArray();
    Export<T>(records, newHeaders);
}

static void Export<T>(IList<T> records, IList<Header> headers)
{
    if (records == null)
        throw new ArgumentNullException("records");
    if (headers == null || headers.Count == 0)
        throw new ArgumentNullException("headers");

    PropertyInfo[] props = new PropertyInfo[headers.Count];
    for (Int32 i = 0; i < headers.Count; i++)
    {
        props[i] = typeof(T).GetProperty(headers[i].Name); //注意属性数组仍然可以有元素为null
    }

    for (Int32 i = 0; i < headers.Count; i++)
    {
        Console.Write(headers[i].PrintName);
        Console.Write("\t");
    }
    Console.WriteLine();

    foreach (var record in records)
    {
        for (Int32 i = 0; i < props.Length; i++)
        {
            if (props[i] != null) //注意null检查
            {
                Object value = props[i].GetValue(record, null);
                Console.Write(value);
                Console.Write("\t");
            }
        }
        Console.WriteLine();
    }
}

调用逻辑与输出如下：

List<Header> headers = new List<Header>();
headers.Add(new Header("ID"));
headers.Add(new Header("Name", "名称"));
headers.Add(new Header("Salary", "薪水"));
Export<Person>(persons, headers);

ID	名称	薪水	
1	Rattz	20.2	
2	Mike	20.2