1. 程式人生 > >EPPlus 讀寫 Excel 資料收集

EPPlus 讀寫 Excel 資料收集

1. EPPlus概述

EPPlus 是使用Open Office XML格式(xlsx)讀寫Excel 2007 / 2010檔案的.net開發庫。 EPPlus 支援:
  • 單元格範圍
  • 單元格樣式(邊框,顏色,填充,字型,數字,對齊)
  • 圖表
  • 圖片
  • 形狀
  • 批註
  • 表格
  • 保護
  • 加密
  • 資料透視表
  • 資料驗證
  • 條件格式
  • VBA
  • 公式計算
  • 更多......

2. EPPlus核心類介紹

2.1  ExcelPackage類

ExcelPackage是EPPlus的入口類,解析一個Excel檔案,生成ExcelWorkbook物件來表示一個Excel。該類實現了IDisposable介面,也就是說可以使用using進行物件釋放。

10個建構函式,下面是常用的3個:

public ExcelPackage();

public ExcelPackage(FileInfo newFile);

public ExcelPackage(Stream newStream);

不管建構函式中傳入的引數是否有效,該類的Workbook屬性都會自動建立,無須擔心空指標問題。

2.2 ExcelWorkbook類

ExcelWorkbook類表示了一個Excel檔案,其Worksheets屬性對應著Excel的各個Sheet。Worksheets屬性會自動建立,不用擔心空指標異常,但是其Count可能為0。

ExcelWorkbook的Properties屬性可以對Office的一些屬性進行設定,例如:

public string Author { get; set; }
public string Title { get; set; }
public string Comments { get; set; }

注意:在獲取具體的Sheet時,索引號從1開始,例如:

ExcelWorksheet sheet = package.Workbook.Worksheets[1];

2.3 ExcelWorksheet類

一些常用屬性:

sheet.DefaultColWidth = 10; //預設列寬
sheet.DefaultRowHeight = 30; //預設行高
sheet.TabColor = Color.Blue; //Sheet Tab的顏色
sheet.Cells.Style.WrapText = true; //單元格文字自動換行

對行列的增刪操作:

public void InsertRow(int rowFrom, int rows);

public void InsertColumn(int columnFrom, int columns);

public void DeleteRow(int rowFrom, int rows);

public void DeleteColumn(int columnFrom, int columns);

設定指定行或列的樣式(寬、高、隱藏、自動換行、數字格式、鎖定等):

sheet.Column(1).Width = 10;
sheet.Row(1).Height = 30;

sheet.Column(1).Hidden = true;
sheet.Row(1).Hidden = true;

sheet.Column(1).Style.WrapText = true;

sheet.Column(1).Style.Numberformat.Format = "$#,###.00";

sheet.Row(1).Style.Locked = true;

自適應寬度設定:

public void AutoFit();
public void AutoFit(double MinimumWidth);
public void AutoFit(double MinimumWidth, double MaximumWidth);
//未傳入MinimumWidth時,使用Sheet的DefaultColWidth作為最小值,此時若沒有提前對DefaultColWidth進行設定就會報錯
//此方法時對自動換行和合並的單元格無效

2.4 ExcelRange類

3個獲取單元格範圍的方法:

public ExcelRange this[string Address] { get; }
//Address是指"A1:C5"這種格式

public ExcelRange this[int Row, int Col] { get; }

public ExcelRange this[int FromRow, int FromCol, int ToRow, int ToCol] { get; }

重要屬性:

public object Value { get; set; }
//獲取或設定單元格的值

複製單元格:

public void Copy(ExcelRangeBase Destination);

從二維資料集合中裝載資料:

public ExcelRangeBase LoadFromCollection<T>(IEnumerable<T> Collection);

public ExcelRangeBase LoadFromDataReader(IDataReader Reader, bool PrintHeaders);

public ExcelRangeBase LoadFromText(FileInfo TextFile);
//這裡的檔案是指CSV檔案

//資料裝載時,會與ExcelRange的行列進行對應,將值設定到其中,這些單元格沒有樣式和數字格式

2.5 樣式

樣式包括字型、顏色、對齊、邊框等。

range.Style.Fill.PatternType = ExcelFillStyle.Solid;
range.Style.Fill.BackgroundColor.SetColor(Color.Gray);
//在設定Style.Fill的其他屬性之前,必須設定PatternType 
//設定了Style.Fill.PatternType之後,必須設定Style.Fill.BackgroundColor,否則單元格背景為黑色
//注意Style.Fill.BackgroundColor是個只讀屬性,需要通過SetColor()方法設定顏色
range.Font.Color.SetColor(Color.Red);
range.HorizontalAlignment = ExcelHorizontalAlignment.CenterContinuous;

2.6  數字格式

range.Style.Numberformat.Format = "$#,###.00";

使用數字格式時,一定要自行檢查格式的正確性,因為產生的過程中EPPlus不會檢查其正確性,如果格式有錯,在開啟產生的Excel檔案時會提示檔案格式不正確。

2.7 公式

sheet.Cells[1, 3].range.Formula = "AVERAGE(A1, B1)";
sheet.Cells[1, 3].FormulaR1C1 = "AVERAGE(RC[-2], RC[-1])";
//以上兩個公式表達意思相同——對於第一行,C列的值等於A列和B列的平均值

使用公式和使用數字格式有同樣的注意事項,需要自行檢查正確性。

建議總是記錄當前Sheet有多少行和列,方便使用公式時定位單元格。

建議對公式相關程式碼進行註釋,有助於其他程式設計師理解。

3. 程式碼示例

下面的連結是VS2015的Solution:

執行效果如圖:

2016012701

點選Export可以把表格中顯示的內容匯出到Excel。

點選RefreshTable可以重新整理表格的內容。

點選Import把匯出的Excel再匯入進來。

Demo中沒有對Excel的內容做完整的驗證,如果手動修改了Excel格式的話,可能會報錯。

4. 參考連結


轉載 :http://epplus.codeplex.com/