この記事ではClosedXMLの基礎的な扱いについて触れます。インポート及びエクスポート（Web画面からのファイル扱い含む）については別記事にする予定です。
ClosedXMLを使用した理由
- 無償かつ商用利用可（MITライセンス）
-
Open XML SDKというMicrosoft公式のSDKをラッパーしている - VBAに似た記述形式で書ける
- 書き込み、読み込みが比較的早い
COM参照について
Googleで「Excel C#」等で検索するとClosedXMLのようなライブラリではなく、Microsoft.Office.Interop.Excelを使ったCOM参照による方法が出てきます。しかし、これは実行時にExcelアプリケーションを実際に用意することが必要になることや、プロセス管理及び処理の面から考えても推奨しません。
詳細は以下のQiita記事（Excelファイルを C# と VB.NET で読み込む "正しい" 方法）で解説されていますのでご確認ください。
グラフ生成について
執筆時点において、ClosedXMLではグラフの生成に対応していません。
グラフが必要な場合はSpreadSheetLight等の類似ライブラリを使用する必要があります。
ClosedXMLの導入
Visual Studioの場合は、NuGetパッケージマネージャーで「ClosedXML」と検索し、インストールしてください。バージョンについて特に指定のない場合は「最新の安定版」を選択してください。
Visual Studio以外の場合やNuGetマネージャーについての詳細は以下公式リンクを参照してください。
操作方法
基本となるコードは以下の通りです。
このコードではSample Sheetというシートを作成し、このシートに値を入力しています。
base.cs
// Excelワークブック(本体)を作成する
using var workbook = new XLWorkbook();
// ワークシートを作成する
var worksheet = workbook.AddWorksheet("Sample Sheet");
// セルを操作する
worksheet.Cell("A1").Value = "Hello World!";
worksheet.Cell(2,1).Value = "Excel Sample";// (2,1)はB1と同一の位置
// Excelワークブック(本体)を保存する
workbook.SaveAs("HelloWorld.xlsx");
Workbook - ワークブック
- 新規作成
- 引数を空にしてXLWorkbookのインスタンスを作成
- 読み込み
- パス指定
- Excelファイルのパスを渡す
- 実データ指定
- MemoryStreamやFileStram等の実データを渡す
- パス指定
- 保存
- パス指定
- 保存したいパスを渡す
- stream保存
- MemoryStreamやFileStram等を渡す
- パス指定
workbook.cs
// 新規作成
using var createWb = new XLWorkbook();
// 読み込み (パス指定)
using var readByPathWb = new XLWorkbook("HelloWorld.xlsx");
// 読み込み (実データ指定)
MemoryStream stream;
using var readByStreamWb = new XLWorkbook(stream);
// 保存 (パス保存)
createWb.SaveAs("SavedExcel.xlsx");
// 保存 (stream保存)
MemoryStream stream;
createWb.SaveAs(stream);
Worksheet - ワークシ－ト
- 追加
- 最後尾に追加
- 引数にシート名を設定してAddWorksheetを呼ぶ
- 挿入
- 引数にシート名と番号を設定してAddWorksheetを呼ぶ（0で1番左に追加）
- 最後尾に追加
- 取得
- シート名指定
- 引数にシート名を指定してWorksheetを呼ぶ
- 番号指定
- 引数にシート番号を指定してWorksheetを呼ぶ（1が1番左のシート）
- シート名指定
worksheet.cs
using var wb = new XLWorkbook();
// 追加 (最後尾に追加)
var addWs = wb.AddWorksheet("worksheetTitle");
// 追加 (挿入)
var insertWs = wb.AddWorksheet("insertWorksheetTitle", 0);
// 取得 (シート名指定)
var readByNameWs = wb.Worksheet("worksheetTitle");
// 取得 (番号指定)
var readByNumberWs = wb.Worksheet(1);// 1番目のシート
Row, Column - 行、列
行と列それぞれ同様の記法で取得可
- 単一取得
- 番号指定で取得（列は"A"等の文字指定可能）
- 複数取得
- 取得範囲を指定（"2:6"、2, 6、"B:F"など複数の方法で指定可能）
- 空白セルを除く指定
- 読み込んだ全セルの内、空白でないセルに対して指定ができる
row-column.cs
using var wb = new XLWorkbook();
var ws = wb.AddWorksheet("sampleWorksheet");
// 単一取得
var row = ws.Row(1);// 1行目取得
var column = ws.Column(1);// 1列目取得
// 複数取得
var allRows = ws.Rows();// 全取得
var allColumns = ws.Columns();// 全取得
var RangeRows = ws.Rows("2:6");// 2行目から6行目取得
var RangeColumns = ws.Columns("2:6");// 2列目から6列目取得 (B:Fと同様)
// 空白セルを除く指定 (Columnも同様に指定可能)
var allUsedRows = ws.RowsUsed();// 空白除く全取得
var lastUsedRows = ws.LastRowUsed();// 空白除く最終行取得
Cell - セル
- セル取得
- 行列や文字列形式で取得可能
- ワークシートや行及び列を基準にして取得
- セル内の値
cell.cs
using var wb = new XLWorkbook();
var ws = wb.AddWorksheet("sampleWorksheet");
var row = ws.Row(1);
var column = ws.Column(1);
// セル取得
var cell = ws.Cell("A1");// A1セル
var cell2 = ws.Cell(1,1);// 1行1列目 (A1セル指定と同様)
var rowCell = row.Cell(1);// 行内の1つ目のセル取得
var columnCell = column.Cell(1);// 列内の1つ目のセル取得
// セル内の書式
cell.Value = "sample value";// 値の設定
cell.Style.Font.SetFontSize(20);// 文字の大きさ
cell.Style.Font.SetFontName("Arial");// 字体
公式ドキュメント
その他の操作は公式ドキュメントをご覧ください。
GitHub - ClosedXML / ClosedXML
Documentation
Wiki