demoshop

官方網站

http://code.google.com/p/linqtoexcel/

NPOI是一個牌子老的好工具，之前我們讀取和寫入 Excel 經常會使用到它，但是最近因為案子需求 demo 只需要讀取 Excel 就在網路上找到了這套 LinqToExcel ，進入官網就有一個影片可以看，看完以後心裡只有一個念頭「就是它了」，試用以後發現的確是不錯，馬上就來推薦給各位。

廢話不多說，就是我需要讀取傳統的 Excel （2003版以前的也就是副檔名不是 xlsx 的），以往都是使用 NPOI，但是他的繁雜有用過的都知道，因此想找看看網路上有沒有其他的替代方案，因而找到此款 LinqToExcel ，使用方式很簡單，下載檔案回來以後我們只需要將自己的專案參考

• LinqToExcel.dll
• Remotion.Data.Linq.dll

就可以正常運作了，基於我很懶的原則，以下範例都使用 LINQPad 來做範例（LINQPad 有在用LINQ不可或缺的好工具）

先出示一下我們的主角 Excel 長啥樣子

上圖同時確定了的確是舊版本的 Excel

---

先來撰寫一個最簡單的範例，就是把資料全部倒出來

void Main()
{
    var fileName=System.IO.Path.Combine(@"R:\","Names.xls");
    var excelFile=new ExcelQueryFactory(fileName);
    
    var excel=excelFile.Worksheet();
    foreach (var element in excel)
    {
        element.Dump();
        "".Dump();
    }
}

執行結果

就這樣相當簡單的就可以把 Excel 讀出來

---

各位看倌可能會覺得，這樣的資料很難用，的確是不太好使用那就來做個 Class 包它吧！

Class 的欄位名稱與 Excel 必須相同（其實也可以不同）

public class exl
{
public string FirstName { get; set; }
public string LastName { get; set; }
public string Role { get; set; }
public string Age { get; set; }
public string 測試中文 { get; set; }
}

寫好 Class 以後再來調整一下剛剛的範例

void Main()
{
    var fileName=System.IO.Path.Combine(@"R:\","Names.xls");
    var excelFile=new ExcelQueryFactory(fileName);
    
    var excel=excelFile.Worksheet<exl>();
    foreach (var element in excel)
    {
        element.Dump();
        "".Dump();
    }
}

執行結果

只需要利用泛型把剛剛的 Class 丟給它就會自動 mapping 過去，十分的方便。

---

再來介紹一下搜尋的用法，有很大的機會我們只要抓出符合條件的資料利用 LinqToExcel 也是可以輕鬆達成

void Main()
{
    var fileName=System.IO.Path.Combine(@"R:\","Names.xls");
    var excelFile=new ExcelQueryFactory(fileName);
    
    var excel=excelFile.Worksheet<exl>()
        .Where(d=>d.Role=="User");
    foreach (var element in excel)
    {
        element.Dump();
        "".Dump();
    }
}

執行結果

---

接著就是一個實務也相當常遇到的需求，雖然說 Source Excel 的欄位定義是洋文，但是秀出來的時候必須要是更有意義的字詞（本範例翻譯成中文....），這時候就可以利用 LinqToExcel 的 AddMapping 功能來達到。

首先先調整 Class

public class exl
{
public string 姓 { get; set; }
public string 名 { get; set; }
public string 角色 { get; set; }
public string 年齡 { get; set; }
public string 測試中文 { get; set; }
}

再來調整 Code

void Main()
{
    var fileName=System.IO.Path.Combine(@"R:\","Names.xls");
    var excelFile=new ExcelQueryFactory(fileName);
    excelFile.AddMapping<exl>(d=>d.姓,"FirstName");
    excelFile.AddMapping<exl>(d=>d.名,"LastName");
    excelFile.AddMapping<exl>(d=>d.角色,"Role");
    excelFile.AddMapping<exl>(d=>d.年齡,"Age");
    
    var excel=excelFile.Worksheet<exl>()
        .Where(d=>d.角色=="Administrator");
    foreach (var element in excel)
    {
        element.Dump();
        "".Dump();
    }
}

執行結果

---

簡單的介紹了幾種常用到的使用方式，官方還有提供更多的範例可以到這裡參考【官方範例】順便一提，這玩意也可以讀取 CSV 檔，如果你對它的原始碼有興趣可以來這裡看看【http://github.com/paulyoder/LinqToExcel】