MyXls: 导出Excel的各种设置

MyXls是一个操作Excel的开源类库，支持设置字体、列宽、行高（由BOSSMA实现）、合并单元格、边框、背景颜色、数据类型、自动换行、对齐方式等，通过众多项目的使用表现，证明MyXls对于创建简单格式的Excel文件十分快捷方便。

各种属性设置MyXls的样式，并附带示例程序的源代码。

        // 准备测试数据
        List<PersonInfo> list = new List<PersonInfo>();
        for (int i = ; i <= ; i++)
        {
            PersonInfo person = new PersonInfo()
            {
                RealName = "张" + i,
                Gender = (i %  ==  ? "男" : "女"),
                Age =  + (i % )
            };

            list.Add(person);
        }

        int recordCount = ; // 要导出的记录总数
        int maxRecordCount = ; // 每个sheet表的最大记录数
        int sheetCount = ; // Sheet表的数目

        XlsDocument xls = new XlsDocument();
        xls.FileName = "MyXls-" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xls";

        // 计算需要多少个sheet表显示数据
        if (recordCount > maxRecordCount)
        {
            sheetCount = (int)Math.Ceiling((decimal)recordCount / (decimal)maxRecordCount);
        }

        // Sheet标题样式
        XF titleXF = xls.NewXF(); // 为xls生成一个XF实例，XF是单元格格式对象
        titleXF.HorizontalAlignment = HorizontalAlignments.Centered; // 设定文字居中
        titleXF.VerticalAlignment = VerticalAlignments.Centered; // 垂直居中
        titleXF.UseBorder = true; // 使用边框
        titleXF.TopLineStyle = ; // 上边框样式
        titleXF.TopLineColor = Colors.Black; // 上边框颜色
        titleXF.LeftLineStyle = ; // 左边框样式
        titleXF.LeftLineColor = Colors.Black; // 左边框颜色
        titleXF.RightLineStyle = ; // 右边框样式
        titleXF.RightLineColor = Colors.Black; // 右边框颜色
        titleXF.Font.FontName = "宋体"; // 字体
        titleXF.Font.Bold = true; // 是否加楚
        titleXF.Font.Height =  * ; // 字大小（字体大小是以 1/20 point 为单位的）

        // 列标题样式
        XF columnTitleXF = xls.NewXF(); // 为xls生成一个XF实例，XF是单元格格式对象
        columnTitleXF.HorizontalAlignment = HorizontalAlignments.Centered; // 设定文字居中
        columnTitleXF.VerticalAlignment = VerticalAlignments.Centered; // 垂直居中
        columnTitleXF.UseBorder = true; // 使用边框
        columnTitleXF.TopLineStyle = ; // 上边框样式
        columnTitleXF.TopLineColor = Colors.Black; // 上边框颜色
        columnTitleXF.BottomLineStyle = ; // 下边框样式
        columnTitleXF.BottomLineColor = Colors.Black; // 下边框颜色
        columnTitleXF.LeftLineStyle = ; // 左边框样式
        columnTitleXF.LeftLineColor = Colors.Black; // 左边框颜色
        columnTitleXF.Pattern = ; // 单元格填充风格。如果设定为0，则是纯色填充(无色)，1代表没有间隙的实色
        columnTitleXF.PatternBackgroundColor = Colors.Red; // 填充的底色
        columnTitleXF.PatternColor = Colors.Default2F; // 填充背景色

        // 数据单元格样式
        XF dataXF = xls.NewXF(); // 为xls生成一个XF实例，XF是单元格格式对象
        dataXF.HorizontalAlignment = HorizontalAlignments.Centered; // 设定文字居中
        dataXF.VerticalAlignment = VerticalAlignments.Centered; // 垂直居中
        dataXF.UseBorder = true; // 使用边框
        dataXF.LeftLineStyle = ; // 左边框样式
        dataXF.LeftLineColor = Colors.Black; // 左边框颜色
        dataXF.BottomLineStyle = ;  // 下边框样式
        dataXF.BottomLineColor = Colors.Black;  // 下边框颜色
        dataXF.Font.FontName = "宋体";
        dataXF.Font.Height =  * ; // 设定字大小（字体大小是以 1/20 point 为单位的）
        dataXF.UseProtection = false; // 默认的就是受保护的，导出后需要启用编辑才可修改
        dataXF.TextWrapRight = true; // 自动换行

        // 遍历创建Sheet
        for (int i = ; i <= sheetCount; i++)
        {
            // 根据计算出来的Sheet数量，一个个创建
            // 行和列的设置需要添加到指定的Sheet中，且每个设置对象不能重用（因为可以设置起始和终止行或列，就没有太大必要重用了，这应是一个策略问题）
            Worksheet sheet;
            if (sheetCount == )
            {
                sheet = xls.Workbook.Worksheets.Add("人员信息表");
            }
            else
            {
                sheet = xls.Workbook.Worksheets.Add("人员信息表 - " + i);
            }

            // 序号列设置
            ColumnInfo col0 = new ColumnInfo(xls, sheet); // 列对象
            col0.ColumnIndexStart = ; // 起始列为第1列，索引从0开始
            col0.ColumnIndexEnd = ; // 终止列为第1列，索引从0开始
            col0.Width =  * ; // 列的宽度计量单位为 1/256 字符宽
            sheet.AddColumnInfo(col0); // 把格式附加到sheet页上

            // 姓名列设置
            ColumnInfo col1 = new ColumnInfo(xls, sheet); // 列对象
            col1.ColumnIndexStart = ; // 起始列为第2列，索引从0开始
            col1.ColumnIndexEnd = ; // 终止列为第2列，索引从0开始
            col1.Width =  * ; // 列的宽度计量单位为 1/256 字符宽
            sheet.AddColumnInfo(col1); // 把格式附加到sheet页上

            // 性别列设置
            ColumnInfo col2 = new ColumnInfo(xls, sheet); // 列对象
            col2.ColumnIndexStart = ; // 起始列为第3列，索引从0开始
            col2.ColumnIndexEnd = ; // 终止列为第3列，索引从0开始
            col2.Width =  * ; // 列的宽度计量单位为 1/256 字符宽
            sheet.AddColumnInfo(col2); // 把格式附加到sheet页上

            // 年龄列设置
            ColumnInfo col3 = new ColumnInfo(xls, sheet); // 列对象
            col3.ColumnIndexStart = ; // 起始列为第4列，索引从0开始
            col3.ColumnIndexEnd = ; // 终止列为第4列，索引从0开始
            col3.Width =  * ; // 列的宽度计量单位为 1/256 字符宽
            sheet.AddColumnInfo(col3); // 把格式附加到sheet页上

            // 行设置
            RowInfo rol1 = new RowInfo(); // 行对象
            rol1.RowHeight =  * ; // 行高
            rol1.RowIndexStart = ; // 行设置起始列，索引从1开始
            rol1.RowIndexEnd = (ushort)(maxRecordCount + ); //行设置结束列
            sheet.AddRowInfo(rol1); // 把设置附加到sheet页上

            // 合并单元格
            //sheet.Cells.Merge(1, 1, 1, 4);
            MergeArea titleArea = new MergeArea(, , , ); // 一个合并单元格实例(合并第1行、第1列 到 第1行、第4列)
            sheet.AddMergeArea(titleArea); //填加合并单元格 

            // 开始填充数据到单元格
            Cells cells = sheet.Cells;

            // Sheet标题行，行和列的索引都是从1开始的
            Cell cell = cells.Add(, , "人员信息统计表", titleXF);
            cells.Add(, , "", titleXF); // 合并单元格后仍需要设置每一个单元格，样式才有效
            cells.Add(, , "", titleXF); // 合并单元格后仍需要设置每一个单元格，样式才有效
            cells.Add(, , "", titleXF); // 合并单元格后仍需要设置每一个单元格，样式才有效
            sheet.Rows[].RowHeight =  * ; // 对指定的行设置行高

            // 列标题行
            cells.Add(, , "序号", columnTitleXF);
            cells.Add(, , "姓名", columnTitleXF);
            cells.Add(, , "性别", columnTitleXF);

            // 最右侧的列需要右边框，通过修改样式columnTitleXF的方式，还可以通过设置单元格属性的方式实现。
            columnTitleXF.RightLineStyle = ;
            columnTitleXF.RightLineColor = Colors.Black;
            cells.Add(, , "年龄", columnTitleXF);

            sheet.Rows[].RowHeight =  * ; // 对指定的行设置行高

            // 行索引
            int rowIndex = ;

            for (int j = ; j < maxRecordCount; j++)
            {
                // 当前记录在数据集合中的索引
                int k = (i - ) * maxRecordCount + j;

                // 如果达到sheet最大记录数则跳出
                if (k >= recordCount)
                {
                    break;
                }

                // 设置单元格的值
                cells.Add(rowIndex, , k + , dataXF);
                cells.Add(rowIndex, , list[k].RealName, dataXF);
                cells.Add(rowIndex, , list[k].Gender, dataXF);

                // 最右侧的列需要右边框，通过给Cell设置属性的方式实现，因为并不是所有的单元格都需要设置，不能通过修改样式dataXF的方式
                Cell lastCell = cells.Add(rowIndex, , list[k].Age, dataXF);
                lastCell.RightLineStyle = ;
                lastCell.RightLineColor = Colors.Black;

                // 行号递增
                rowIndex++;
            }
        }

        // 在浏览器中输出Excel文件
        xls.Send();
    }