【ClosedXML】 セルの値

　今回はセルの取得方法とセルの値について説明します。
　セルはワークシートやセル範囲等のCellメソッドから取得できます。

using ClosedXML.Excel;
using System;

namespace ClosedXml04
{
    class Program
    {
        static void Main(string[] args)
        {
            using(var book = new XLWorkbook(XLEventTracking.Disabled))
            {
                var sheet = book.AddWorksheet("シート1");

                // セルの取得
                var cell1 = sheet.Cell("A1");   // A1
                var cell2 = sheet.Cell(2, 1);   // A2
                var cell3 = sheet.Cell(3, "A"); // A3
                var cell4 = sheet.Cell(cell1.Address);

                // セルに値を入力
                cell1.Value = "値";
                cell2.Value = 12.3;
                cell3.Value = DateTime.Now;

                // セルの値を取得
                Console.WriteLine("string:{0}", cell1.GetString());
                Console.WriteLine("double:{0}", cell2.GetDouble());
                Console.WriteLine("DateTime:{0}", cell3.GetDateTime());
                Console.WriteLine("型変換:{0}", cell2.GetValue<double>());
            }
        }
    }
}

　Cellメソッドの引数には取得したいセルの位置を指定しますが、セルの位置の指定方法にはいくつか種類があります。
　固定位置の場合は"A1"の様にセル番地を指定するのが解りやすいです。
　一定の範囲のセルをループ処理するときなどは行番号と列番号を指定する方が使いやすいです。（列番号や行番号は1から開始されます）
　状況に合わせて使いやすい方法でセルを取得してください。

　セルの値はValueプロパティで管理されています。
　Valueプロパティのデータ型はobjectなのでどんな値でも代入できます。
　値のデータ型はExcelファイルに保存したときの表示形式に影響します。(Excelのバージョンによって多少結果がことなるかもしれません。）
　Valueの型はobjectなのでセルから値を取り出す時は型変換が必要になります。
　単純にValueプロパティの値をキャストしてもかまいませんが、型変換した値を返すメソッドが用意されています。
　例えば、文字列として返してほしい場合はGetStringメソッド、doubleで返してほしい場合はGetDoubleメソッドを使用します。
　また、GetValue<T>メソッドを使用することで指定した型に変換した結果を取得することもできます。

【ClosedXML】 ワークシートの作成、取得

　ClosedXMLでExcelファイルの操作を行う場合は、Bookを作成（又は読み込み）した後に、ワークシートを作成したり、目的のワークシートを取得する必要があります。
　まずはワークシートの作成方法について説明します。

using ClosedXML.Excel;
using System;

namespace ClosedXml03
{
    class Program
    {
        static void Main(string[] args)
        {
            using(var book = new XLWorkbook(XLEventTracking.Disabled))
            {
                // ワークシートを作成
                var sheet1 = book.AddWorksheet("シート1");
                var sheet2 = book.Worksheets.Add("シート2");   // こっちでもOK
                var sheet0 = book.AddWorksheet("シート0", 1);  // シート0を最初のシートとして作成
                
                // 既に存在するシート名を追加すると例外発生
                //var sheet3 = book.Worksheets.Add("シート2");
            }
        }
    }
}

　ワークシートの作成方法は2種類あり、どちらを使ってもかまいません。
　１つはXLWorkbookインスタンスのAddWorksheetメソッドを使用する方法です。
　もう１つはXLWorkbookインスタンスのWorksheetsプロパティのAddメソッドを使用する方法です。
　どちらのメソッドも引数にワークシートの名前を指定し、戻り値に作成したワークシートのインスタンスを返します。
　既存ワークシートと同名のワークシートを作ろうとすると例外が発生しますので、注意してください。
　これらのワークシート作成メソッドにシート名だけを指定した場合は、新規ワークシートはWorksheetsの最後に追加されます。
　ワークシート作成メソッドの第2引数に新規ワークシートの位置を指定することで、新規ワークシートを任意の位置に作成することができます。

　次に、ワークシートを取得する方法について説明します。

using ClosedXML.Excel;
using System;

namespace ClosedXml03
{
    class Program
    {
        static void Main(string[] args)
        {
            using(var book = new XLWorkbook(XLEventTracking.Disabled))
            {
                 // ワークシートを取得する
                var sheet1 = book.Worksheet(1);  // positionは1から開始
                Console.WriteLine(sheet1.Name);  // シート1

                var sheet2 = book.Worksheet("シート2");
                Console.WriteLine(sheet2.Name);  // シート2

                IXLWorksheet sheet3;
                if(book.TryGetWorksheet("シート3", out sheet3))
                {
                    Console.WriteLine(sheet3.Name);
                }
                else
                {
                    Console.WriteLine("ワークシートを取得できませんでした。");
                }
            }
        }
    }
}

　ワークシートを取得する場合はXLWorkbookインスタンスのWorksheetメソッドを使用します。
　Worksheetメソッドの引数には、ワークシート番号（１から開始）かワークシート名を指定します。
　Worksheetメソッドに存在しないシート番号やシート名を指定すると例外が発生します。
　例外処理が面倒な場合はTryGetWorksheetメソッドを使用する方法もあります。
　TryGetWorksheetメソッドでは戻り値でワークシートの取得が成功したかどうかを判断できます。

【ClosedXML】 Excelブックの作成、読み込み

　ClosedXMLでExcelファイルを扱う為には、まず最初にXLWorkbookインスタンスを作成する必要があります。
　Excelファイルを新たに作成したい場合は以下の様にします。

using(var book = new XLWorkbook())
{
    // エクセルファイルに書き込み

    book.SaveAs(path);
}

　コンストラクタでExcelファイルのPathを指定しない場合は空のブックが作成されます。
　あとはそのブックにシートを追加し、セルに値を入力する等していきます。
　最後にSaveAsメソッドでExcelファイルを保存します。

　既存のExcelブックを読み込みたい場合は以下の様にします。

using(var book = new XLWorkbook(path))
{
    // エクセルファイルの読み込み、編集

    book.Save();
}

　XLWorkbookのコンストラクタで読み込みたいExcelファイルのPathを指定します。
　このときExcelファイルを開いている場合はファイルがロックされていて読み込めないため例外が発生しますので、注意してください。
　後は、ワークシートやセルから情報を読み取るだけです。
　もちろん、読み込んだExcelブックを編集することもできます。
　編集した場合は最後にSaveメソッドを実行し、編集内容を保存してください。
　新たにExcelファイルを作成する場合も、Excelファイルを読み込む場合でも、XLWorkbookインスタンスは最後にDisposeする必要があります。

　以下は単純なExcelブック操作のサンプルコードです。

using ClosedXML.Excel;
using System;
using System.IO;

namespace ClosedXml02
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Desktop), "ブック.xlsx");

            // Excelファイル作成
            using (var book = new XLWorkbook(XLEventTracking.Disabled))
            {
                var sheet = book.AddWorksheet("しーと");
                sheet.Cell("A1").Value = "値";

                book.SaveAs(path);
            }
                    
            // Excelファイルを読み込み
            using(var book = new XLWorkbook(path, XLEventTracking.Disabled))
            {
                var sheet = book.Worksheet("しーと");
                sheet.Cell("A1").Value = "Value";

                book.Save();
            }
        }
    }
}

　このサンプルではExcelファイルを作成した後に、そのファイルを開きA1セルの値を変更しています。
　（シートやセルの操作については次回以降に説明するので省略します）
　このサンプルでは、XLWorkbookのコンストラクタでXLEventTracking.Disabledを指定しています。こうすることで、行や列等の追加・削除に伴う追跡を行わないようにできます。
　ClosedXMLではシートや列、行等の追加や削除を追跡しています。そのため、巨大なExcelファイルを扱う場合には追跡イベントが大量に発生するためパフォーマンスが悪化します。
　また、巨大なExceファイルを使用する場合は列や行等を扱う場合に逐一Disposeすることが推奨されています。
　Excelファイルを新たに作成したり、ファイルから情報を読み取ったりするだけならこういった追跡は必要ありません。(ほとんどの場合で必要ないと思われます。）
　そんな場合は追跡機能をOFFにすることでパフォーマンスを改善できます。また、ループの際に一々Disposeする必要もなくなります。(XLWorkbookのDisposeは必要です）
　

ClosedXMLの紹介

　C#でExcelファイルを扱う方法はいくつかありますが、ここではClosedXMLを使ってみたいと思います。
　ClosedXMLを選んだ理由ですが、
１）COMは面倒くさいので使いたくない。
２）ExcelがインストールされていないPCでも使用できる。
３）Excelのマクロをかじったことがある人なら書式設定等が直感的でわかりやすい。
の3点です。
　ClosedXMLはOpenXML SDKを使っています。そのため、ClosedXMLで操作可能なExcelファイルは拡張子が.xlsxのファイルだけです。Excel97-2003形式(.xlsのファイル）は使用できません。
　ClosedXMLはNuGetからインストールできます。(OpenXML SDKも一緒にインストールしてくれるようです）


　今回はClosedXMLでのExcel操作がどんな感じなのかを見てもらうために簡単なExcelファイルを作成してみます。

using ClosedXML.Excel;
using System;
using System.IO;

namespace ClosedXml01
{
    class Program
    {
        static void Main(string[] args)
        {
            var filePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Desktop), "ClosedXMLデモ.xlsx");

            using(var book = new XLWorkbook())
            {
                var worksheet = book.AddWorksheet("シート1");
                var cell = worksheet.Cell("B2");
                cell.Value = "Hello World!";
                cell.Style.Font.FontSize = 24;
                cell.Style.Font.FontColor = XLColor.Red;
                cell.Style.Border.OutsideBorder = XLBorderStyleValues.Thin;
                worksheet.Column(2).AdjustToContents();

                book.SaveAs(filePath);
            }
        }
    }
}

　このプログラムを実行すると以下の様なExcelファイルが作成されます。

　次回からClosedXMLを使用したExcelファイル操作について説明していきたいと思います。