一个操作EXCEL的C#类ExcelUtils
近期在公司里一直从事服务类的工作,涉及到非常多excel的处理。部分工作内容是每天反复的,仅仅是每天的数据不同而已。我遇到的一个问题是客户每天发送的几种数据有些excel中的字段顺序是一致的,有些是不一致的,而对数据汇总就要一列一列的去调整,剪切,复制。粘贴,非常麻烦。
还有类似导入、导出数据、类似的问题。
熟悉EXCEL的人肯定知道,事实上EXCEL中为我们提供了非常多经常使用的功能,比方筛选、排序、透视表统计等。仅仅是须要手动去操作。实际这些经常使用操作全然能够用程序去替代,解放我们的双手。须要注意的是。写这样的工具要注意一些数据中的细节,或者在程序处理前,我们定义一些约定俗成的规则, 比方文件名称,比方excel表中确保每一个页都存在表头等,之后再用我们的程序取代excel去自己主动处理,这样就一键搞定。
想到写这样的工具,我会想到考虑用C#、python之类的语言,简单粗暴。方便快捷,相比c/c++开发快的多。因为笔者对python GUI的部分不是非常了解。并且假设用python,每次在命令行运行,想想也非常麻烦。于是决定採用.net framework中提供对office操作的接口。採用C#语言来实现。
用C#操作EXCEL,一种方法是将EXCEL文件作为数据源,像数据库一样的读写,能够採用odbc的方式,比如:
#region 将Excel文件路径和页名称转换成DataTable /// <param name="str_path">excel文件路径</param> /// <param name="str_sheet">页名称</param> /// <returns>返回一个DataTable对象</returns> public static System.Data.DataTable ExcelToDT(string str_path, string str_sheet) { string str_conn = "Provider=Microsoft.ACE.OLEDB.12.0;" + //string str_conn = "Provider=Microsoft.Jet.OLEDB.4.0;" + "Data Source=" + str_path + ";" + "Extended Properties=Excel 8.0;"; OleDbConnection ole_conn = new OleDbConnection(str_conn); ole_conn.Open(); string str_excel = "select * from [" + str_sheet + "$]"; OleDbDataAdapter ole_cmd = new OleDbDataAdapter(str_excel, str_conn); DataSet ds = new DataSet(); ole_cmd.Fill(ds); return ds.Tables[0]; } #endregion
还有一种用Visual Studio Tools for Office API Reference ,它是执行使用 Microsoft Visual Studio生成的基于office的解决方式所必需的api。
这里不会解说关于该api怎样使用。我将他封装成了一个类。假设你急需处理EXCEL而没有时间去了解Office API,那么能够使用这个封装好的类,相信使用起来更方便,因为时间仓促,也仅仅是实现了主要的功能。只是对于一般的处理已经足够。
了解之前:
确保你已经引用了Microsoft.Excel 这个com
首先你要知道:
1.一个ExcelUtils对象相应一个excel中的一个页,也就是说我们通常仅仅关注一个页中的二维数据,就像数据库中的一个表,或者假设你熟悉Ado.net,能够把它想象成一个DataTable,相信以后不断完好。它会变成一个DataSet,只是时间仓促,我也临时封装到这里,实现功能先~~~
2.EXCEL中的行号和列号都是从1開始的,不是0!并且假设excel数据中有表头。那么数据部分的起始位置为2,,1为表头。
用法,很easy:
1.打开数据
ExcelUtils exUtil = new ExcelUtils(); exUtil.Open("xxxx.xlsx", "Sheet1");
使用简单,假设你熟悉Ado,net 相信你对conn.Open()一定不会陌生,是的,我们通过例如以下代码,打开某个Excel文件的某个页
这里我们打开"xxxx.xlsx"这个excel文件里的"Sheet1"这个页,自此exUtil就相应这个页中的二维表
2.读写数据
这里ExcelUtils类中提供了一些主要的excel操作方法。
SetValue方法,该方法设置某单元格的值
/// <param name="row">行号</param> /// <param name="col">列号</param> /// <param name="str_value">待写入的值</param> public void SetValue(int row, int col, string str_value);
GetValue方法。与SetValue方法相相应。获取某单元格的值
/// <param name="row">行号</param> /// <param name="col">列号</param> /// <returns>该单元格的string值</returns> public string GetValue(int row, int col);
GetColNoByName方法,该方法通过字段名返回该字段所在的列号,以方便通过列号对数据进行读写
/// <param name="colName">要查找的列名</param> /// <returns>找到返回序号,找不到返回-1</returns> public int GetColNoByName(string colName);
GetCurSheetUsedRangeRowsCount方法,好吧,名字有点长~,有待该进。。。
该方法用户获取当前页中已用的最大行号
/// <returns>返回已用的最大行号</returns> public int GetCurSheetUsedRangeRowsCount();
有时我们须要知道数据在当前页中最末尾在哪一行,然后接下来附加数据在最大行号的下一行開始写数据。例如以下图中,调用GetCurSheetUsedRangeRowsCount()将返回4。个人觉得这个比較经常使用.
BoxToBoxWrite方法。非常好理解,拷贝一个单元格的值到还有一个单元格。这两个单元格能够在不同的excel文件里。
/// <param name="getUtil">获取数据的ExcelUtils对象</param> /// <param name="g_row">获取数据的ExcelUtils对象的某单元格行号</param> /// <param name="g_col">获取数据的ExcelUtils对象的某单元格列号</param> /// <param name="setUtil">待写入数据的ExcelUtils对象</param> /// <param name="s_row">待写入数据的ExcelUtils对象的某单元格行号</param> /// <param name="s_col">待写入数据的ExcelUtils对象的某单元格列号</param> public static void BoxToBoxWrite(ExcelUtils getUtil, int g_row, int g_col, ExcelUtils setUtil, int s_row, int s_col);
ColToColWrite方法,将某excel中的某一字段从o_row_start到o_row_end复制到还有一个excel某字段,而且从还有一个excel的s_row_start行開始写入
注意:假设你想从excel的已用最大行下一行開始写入,那么s_row_start通常为: 先调用GetCurSheetUsedRangeRowsCount()获取已用最大行号后 +1,表示从已用最大行下一行開始写入
/// <param name="origUtil">源ExcelUtils对象</param> /// <param name="origColName">源ExcelUtils对象中要操作的列名</param> /// <param name="o_row_start">复制数据的起始行号</param> /// <param name="o_row_end">复制数据的结束行号</param> /// <param name="srcUtil">待写入的ExcelUtil对象</param> /// <param name="srcColName">待写入的列名</param> /// <param name="s_row_start">从s_row_start行開始写入</param> public static void ColToColWrite(ExcelUtils origUtil, string origColName, int o_row_start, int o_row_end, ExcelUtils srcUtil, string srcColName, int s_row_start)
CloseAndSave方法
最后。相同类似Ado.net,Open之后不要忘记关闭。这里ExcelUtils对象相应一个Excel中的页,调用CloseAndSave(),之前的写入操作才会保存。
public void CloseAndSave();
ExcelUtils完整代码
using System; using System.Collections.Generic; using System.Linq; using System.Text; using Microsoft.Office.Interop.Excel; using System.Reflection; using System.IO; namespace AutoReportDeal { class ExcelUtils { public Microsoft.Office.Interop.Excel.Application xlsApp = null; public Microsoft.Office.Interop.Excel.Workbook workbook = null; public Microsoft.Office.Interop.Excel.Worksheet worksheet = null; public string str_this_path = null; public string str_this_sheet = null; #region 打开某EXCEL文件的某个页 /// <param name="str_path">EXCEL文件路径</param> /// <param name="str_sheet">要操作的页</param> public void Open(string str_path, string str_sheet) { str_this_path = str_path; str_this_sheet = str_sheet; //Excel Application xlsApp = new Microsoft.Office.Interop.Excel.Application(); //Excel Workbook workbook = xlsApp.Workbooks.Open(str_path, 0, true, 5, System.Reflection.Missing.Value, System.Reflection.Missing.Value, false, System.Reflection.Missing.Value, System.Reflection.Missing.Value, true, false, System.Reflection.Missing.Value, false, false, false); //Excel Worksheet worksheet = (Worksheet)workbook.Worksheets[str_sheet]; } #endregion #region 将值写入某单元格 /// <param name="row">行号</param> /// <param name="col">列号</param> /// <param name="str_value">待写入的值</param> public void SetValue(int row, int col, string str_value) { if (row <= 0 || col <= 0 || str_value == null) throw new Exception("參数不合法"); worksheet.Cells[row, col] = str_value; } #endregion #region 获取当前可用页中的已用的最大行号 /// <returns>返回已用的最大行号</returns> public int GetCurSheetUsedRangeRowsCount() { if (xlsApp == null) throw new Exception("ExcelUtils对象尚未Open()"); int used_rng_rows = worksheet.UsedRange.Rows.Count; return used_rng_rows; } #endregion #region 查找某字段名的列号(列号从1開始) /// <param name="colName">要查找的列名</param> /// <returns>找到返回序号,找不到返回-1</returns> public int GetColNoByName(string colName) { int col_used = worksheet.UsedRange.Columns.Count; for (int i = 1; i <= col_used; ++i) { if (GetValue(1, i).ToString().Trim() == colName) return i; } return -1; } #endregion #region 得到某一单元格的值 /// <param name="row">行号</param> /// <param name="col">列号</param> /// <returns>该单元格的string值</returns> public string GetValue(int row, int col) { if (row <= 0 || col <= 0) throw new Exception("參数不合法"); Range myRange = null; myRange = worksheet.get_Range(worksheet.Cells[row, col], worksheet.Cells[row, col]); string str = myRange.Text.ToString(); return str; } #endregion #region 将某excel当前页的某单元格的值写入到还有一个excel当前页的某单元格 /// <param name="getUtil">获取数据的ExcelUtils对象</param> /// <param name="g_row">获取数据的ExcelUtils对象的某单元格行号</param> /// <param name="g_col">获取数据的ExcelUtils对象的某单元格列号</param> /// <param name="setUtil">待写入数据的ExcelUtils对象</param> /// <param name="s_row">待写入数据的ExcelUtils对象的某单元格行号</param> /// <param name="s_col">待写入数据的ExcelUtils对象的某单元格列号</param> public static void BoxToBoxWrite(ExcelUtils getUtil, int g_row, int g_col, ExcelUtils setUtil, int s_row, int s_col) { if (getUtil == null || setUtil == null) throw new Exception("ExcelUtils对象尚未Open()"); if (g_row <= 0 || g_col <= 0 || s_row <= 0 || s_col <= 0) throw new Exception("參数不合法"); string str_to_write = getUtil.GetValue(g_row, g_col); setUtil.SetValue(s_row, s_col, str_to_write); } #endregion #region 将某excel页中某列从o_row_start到o_row_end的数据写入到还有一个Excel页中,并从s_row_start行位置開始写入 /// <param name="origUtil">源ExcelUtils对象</param> /// <param name="origColName">源ExcelUtils对象中要操作的列名</param> /// <param name="o_row_start">复制数据的起始行号</param> /// <param name="o_row_end">复制数据的结束行号</param> /// <param name="srcUtil">待写入的ExcelUtil对象</param> /// <param name="srcColName">待写入的列名</param> /// <param name="s_row_start">从s_row_start行開始写入</param> public static void ColToColWrite(ExcelUtils origUtil, string origColName, int o_row_start, int o_row_end, ExcelUtils srcUtil, string srcColName, int s_row_start) { if (origUtil.worksheet == null || srcUtil.worksheet == null) throw new Exception("ExcelUtils对象尚未Open()"); if (origColName == null || srcColName == null || o_row_start <= 0 || o_row_end <= 0 || s_row_start <= 0 || o_row_start > o_row_end) throw new Exception("參数不合法"); int o_col_index = origUtil.GetColNoByName(origColName); if (o_col_index < 0) throw new Exception("列名不存在"); int s_col_index = srcUtil.GetColNoByName(srcColName); if (s_col_index < 0) throw new Exception("列名不存在"); for (int i = o_row_start, j = s_row_start; i <= o_row_end; ++i, ++j) { BoxToBoxWrite(origUtil, i, o_col_index, srcUtil, j, s_col_index); } } #endregion #region 保存并关闭 public void CloseAndSave() { xlsApp.DisplayAlerts = false; xlsApp.AlertBeforeOverwriting = false; if (File.Exists(str_this_path)) { File.Delete(str_this_path); } xlsApp.ActiveWorkbook.SaveCopyAs(str_this_path); xlsApp.Quit(); xlsApp = null; workbook = null; worksheet = null; str_this_path = null; } #endregion } }时间紧急。先到这里~~