【C#】ClosedXMLでエクセルを操作する方法をまとめてみた

using ClosedXML.Excel;

// パターン 1
var wb = new XLWorkbook();
try
{
    // 何かしらの処理をここに書く
}
finally
{
    // finally句でDisposeを呼び出す
    wb.Dispose();
}

// パターン 2
using (var wb = new XLWorkbook())
{
    // 何かしらの処理をここに書く
}

using (var wb = new XLWorkbook(@"C:\Users\Desktop\test.xlsx")) 
{
    // 何かしらの処理をここに書く
}

using (var wb = new XLWorkbook(@"C:\Users\Desktop\test.xlsx")) 
{
    // 上書き保存する
    wb.Save();
}

using (var wb = new XLWorkbook())
{
    wb.Worksheets.Add();
    wb.Save();
    // Saveメソッドが実行されると、次の例外メッセージが表示されます。
    // System.InvalidOperationException: 'This is a new file. Please use one of the 'SaveAs' methods.'
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    wb.Worksheets.Add();

    // test.xlsxとして保存する
    wb.SaveAs(@"C:\Users\Desktop\test.xlsx");
}

using (var wb = new XLWorkbook())
{
    var ws = wb.Worksheets.Add();
}

using (var wb = new XLWorkbook())
{
    var ws = wb.Worksheets.Add("新しいシート名");
}

using (var wb = new XLWorkbook())
{
    var ws = wb.Worksheets.Add("新しいシート名", 0);
}

using (var wb = new XLWorkbook())
{
    // Sheet1、Sheet2を追加する
    wb.Worksheets.Add();
    wb.Worksheets.Add();

    // Sheet1のワークシートのオブジェクトを取得する
    var ws = wb.Worksheet("Sheet1");
}

using (var wb = new XLWorkbook())
{
    // Sheet1、Sheet2を追加する
    wb.Worksheets.Add();
    wb.Worksheets.Add();

    // 追加したSheet1を削除する
    wb.Worksheets.Delete(1);
}

using (var wb = new XLWorkbook())
{
    // Sheet1、Sheet2、Sheet3、Sheet4を追加する
    wb.Worksheets.Add();
    wb.Worksheets.Add();
    wb.Worksheets.Add();
    wb.Worksheets.Add();

    // Sheet1を3番目に移動する
    wb.Worksheet("Sheet1").Position = 3;
}

using (var wb = new XLWorkbook())
{
    // Sheet1、Sheet2を追加する
    wb.Worksheets.Add();
    wb.Worksheets.Add();

    // Sheet1をコピーして、CopySheetを追加する
    var ws = wb.Worksheet("Sheet1");
    ws.CopyTo("CopySheet");
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // Sheet1のセルA1を指定する
    var cell = ws.Cell(1, 1);

    // セルに値をセットする
    cell.SetValue("TEST");
    // 以下でもOK
    // cell.Value = "TEST";

    // SetValueメソッドで値をセットし、セルの背景を黄色にする
    cell.SetValue("TEST")
        .Style.Fill.SetBackgroundColor(XLColor.Yellow);
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1～G4セルにまとめて値をセットする
    ws.Range(1, 1, 4, 7).SetValue("10");
    // 下記でもOK
    // ws.Range(1, 1, 4, 7).Value = "10";
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1に値を設定する
    ws.Cell(1, 1).SetValue("TEST");

    // A1の値を取得する
    var value = ws.Cell(1, 1).Value.ToString();

    // デバッグへ出力する
    Debug.WriteLine(value);
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1に値をセット
    ws.Cell(1, 1).SetValue("TEST");

    // A1の値を取得する
    XLCellValue value = ws.Cell(1, 1).Value;

    if (value.IsText)
    {
        // 文字列型で取得する
        string text = value.GetText();
    }
    else if (value.IsNumber)
    {
        // 数値型（double）で取得する
        double num = value.GetNumber();
    }
    else if (value.IsDateTime)
    {
        // 日付型で取得する
        DateTime date = value.GetDateTime();
    }
    else if (value.IsBoolean)
    {
        // Boolean型で取得する
        bool text = value.GetBoolean();
    }
    else if (value.IsTimeSpan)
    {
        // TimeSpan型で取得する
        TimeSpan text = value.GetTimeSpan();
    }
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1とB1に値を設定する
    ws.Cell(1, "A").SetValue(2);
    ws.Cell(1, "B").SetValue(3);

    // C1に式を設定する
    var cell = ws.Cell(1, "C").SetFormulaA1("=A1*B1");

    // デバッグへ出力する
    Debug.WriteLine(cell.Value.ToString());
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1とB1に値を設定する
    ws.Cell(1, 1).SetValue(2);
    ws.Cell(1, 2).SetValue(3);

    // C1に式を設定する
    var cell = ws.Cell(1, 3).SetFormulaR1C1("R1C1*R1C2");
    // 下記でもOK（相対参照を使用した例）
    // var cell = ws.Cell(1, 3).SetFormulaR1C1("RC[-2]*RC[-1]");

    // デバッグへ出力する
    Debug.WriteLine(cell.Value.ToString());
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1に値を設定する
    ws.Cell("A1").SetValue("Hello World");

    // A1のフォントを設定する
    ws.Cell("A1").Style
        .Font.SetBold(true)                           // 太字
        .Font.SetFontColor(XLColor.Red)               // 文字色
        .Font.SetFontName("メイリオ")                  // フォント名
        .Font.SetFontSize(20)                         // フォントサイズ
        .Font.SetUnderline()                          // 下線
        .Fill.SetBackgroundColor(XLColor.LightGray);  // 背景
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    //セルの４箇所に罫線を引く
    ws.Cell("B2").Style.Border.SetOutsideBorder(XLBorderStyleValues.Thin);   //細線
    ws.Cell("B4").Style.Border.SetOutsideBorder(XLBorderStyleValues.Thick);  //太線
    ws.Cell("D2").Style.Border.SetOutsideBorder(XLBorderStyleValues.Dotted); //点線
    ws.Cell("D4").Style.Border.SetOutsideBorder(XLBorderStyleValues.Medium); //中太線

    //部分罫線を引く
    ws.Cell("F2").Style.Border.SetTopBorder(XLBorderStyleValues.Thin);       //上だけ
    ws.Cell("F4").Style.Border.SetBottomBorder(XLBorderStyleValues.Thin);    //下だけ
    ws.Cell("H2").Style.Border.SetLeftBorder(XLBorderStyleValues.Thin);      //左だけ
    ws.Cell("H4").Style.Border.SetRightBorder(XLBorderStyleValues.Thin);     //右だけ
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    // A1に値を設定する
    var cell1 = ws.Cell("A1").SetValue(0.103);

    // 数値の書式を設定する
    cell1.Style.DateFormat.Format = "0.0%;▲0.0%;- ";

    // A2に値を設定する
    var cell2 = ws.Cell("A2").SetValue(new DateTime(2023, 11, 2));

    // 数値の書式を設定する
    cell2.Style.DateFormat.Format = "yyyy-MM-dd";

    wb.SaveAs("sample.xlsx");
}

using (var wb = new XLWorkbook())
{
    // Sheet1を追加する
    var ws = wb.Worksheets.Add();

    var cell1 = ws.Cell("A1");
    var cell2 = ws.Cell("A2");

    // A1とA2に条件付き書式を設定する。
    // 値が「OK」なら背景色を緑、値が「NG」なら背景色を赤」にする。
    cell1.AddConditionalFormat().WhenEquals("OK").Fill.SetBackgroundColor(XLColor.LightGreen);
    cell2.AddConditionalFormat().WhenEquals("NG").Fill.SetBackgroundColor(XLColor.BrickRed);

    // A1とA2に値を設定する
    cell1.SetValue("OK");
    cell2.SetValue("NG");

    wb.SaveAs("sample.xlsx");
}