C#でExcelファイルを開く方法

IronXL の主な機能は何ですか?

• LoadSpreadsheetsを使用して、XLS/XLSX/CSV/TSV 形式のデータを開き、読み取り、検索します。
• "保存とエクスポート"を使用して、 Excel ワークシートを複数の形式にエクスポートします。 -安全な機能を使用して、パスワードでファイルを暗号化および復号化します。
• DataSet 統合を通じて、Excel シートをDataSetおよびDataTableオブジェクトとして操作します。
• Excel の数式は自動的に再計算され、数学関数をサポートします。
• WorkSheet["A1:B10"]のような直感的な範囲構文を使用してスプレッドシートデータを編集します。 -セル範囲、列、行を並べ替えます。 -フォント、背景、境界線、配置、数値の形式でセルのスタイルを設定します。

始める前に何が必要ですか?

C# アプリケーションで IronXL を使用するには、以下のコンポーネントをローカルコンピュータにインストールしてください:

1. Visual Studio - C# .NET アプリケーションを開発するための公式 IDE。 Visual Studio はMicrosoft のウェブサイトからダウンロードしてインストールできます。 JetBrains ReSharper & Riderも使用できます。 追加のセットアップ ガイダンスについては、"はじめにの概要"を参照してください。
2. IronXL - C# で Excel シートを操作するのに役立つ Excel ライブラリ。 使用する前にC#アプリケーションにインストールする必要があります。 NuGet Web サイトまたは Visual Studio の NuGet パッケージの管理からダウンロードできます。 また、.NET Excel DLLファイルを直接ダウンロードすることもできます。 ライセンスの実装については、 "ライセンス キーの使用"を参照してください。

どの名前空間をインポートすればよいですか?

Visual Studio と IronXL がインストールされたら、以下の行を C# ファイルの先頭に追加して、必要な IronXL 名前空間を追加します。

// Add reference to the IronXL library
using IronXL;

// Add reference to the IronXL library
using IronXL;

特定の Excel 形式または高度な機能を操作するには、次のものも必要になる場合があります。

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

既存の Excel ファイルを読み込むにはどうすればよいでしょうか?

Excel ファイルは、ワークブックとも呼ばれ、各シートにセル値が含まれる複数のワークシートで構成されています。 Excel ファイルを開いて読み取るには、 WorkBookクラスのLoadメソッドを使用してファイルを読み込みます。 LoadSpreadsheets機能はさまざまな形式をサポートしています。

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

これにより、ワークブックが WorkBook インスタンスとして初期化されます。 特定のWorkSheetを開くには、 WorkSheetsコレクションからそれを取得します。 ワークシートの管理ガイドでは、ワークシートの操作についてさらに詳しく説明しています。

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

これにより、Excel ファイルの最初のシートにアクセスし、読み取りおよび書き込み準備が整います。

! 5人の従業員の名前、役職、給与の列を含む従業員データを表示したExcelスプレッドシート。ヘッダーとセルの境界線がフォーマットされています。 Excel ファイル

Excel セルからデータを読み取るにはどうすればいいですか?

Excel ファイルを開くと、データの読み取り準備が完了します。 IronXL を使用して C# で Excel ファイルからデータを読み取るのは簡単です。 範囲選択機能を使用してセル参照を指定することで、セルの値を読み取ることができます。

次のコードは、セルの値を取得します:

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

出力は以下の通りです。

! Microsoft Visual Studio デバッグコンソールウィンドウに、Excel セル C2 から値 '100000' の抽出が成功し、コンテキスト出力メッセージが表示されています。 Excel の読み取り

セルの範囲からデータを読み取るには、ループを使用して指定された範囲を反復処理します。 Excel 範囲の選択の例では、さらに多くのパターンが提供されています。

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

セル範囲 A2:A6 の各値にアクセスしてコンソールに印刷します。

! Microsoft Visual Studio デバッグ コンソールで構文が強調表示され、Excel 範囲 A2:A6 の読み取り結果が表示され、従業員名 John、Sara、Peter、Method、Katherine が表示されています。 セル範囲の読み取り

より詳しい読み取りおよび書き込みの例については、 C# での Excel 読み取りチュートリアルを参照してください。 操作を容易にするために、 Excel データを DataTables に変換することもできます。

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

新しい Excel ファイルを作成するにはどうすればよいでしょうか?

IronXL では、データの保存と取得のための新しいワークブックの作成も容易になります。 スプレッドシートの作成ガイドでは、包括的な例が提供されています。

1 行のコードで新しい Excel ファイルを作成できます:

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

次に、ワークシートを作成し、データを追加します。 より高度な作成パターンについては、 "新しい Excel ファイルを作成する"を参照してください。

ワークブックにワークシートを追加するにはどうすればよいですか?

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

"GDPByCountry"と名付けられたワークシートをワークブックに追加し、セル値を追加できるようにします。 ワークシートの管理とワークシートのコピーの詳細については、こちらをご覧ください。

特定のセルに値を設定するには、以下のコードを使用します:

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

最終出力は以下の通りです:

! Excel スプレッドシートのセル A1 に、C# を使用してプログラム的に追加された"例"テキストが表示され、GDPByCountry ワークシートタブが表示され、追加された値を示すためにセルが強調表示されています。 セルに値を追加

さまざまな Excel 形式の操作

IronXL は複数の Excel 形式をサポートしています。 さまざまなファイル タイプを処理する方法は次のとおりです。

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

スプレッドシートのファイル形式の変換とXLSX から CSV、JSON、XML への変換について詳しく学習します。

エラー処理とベストプラクティス

Excel ファイルを操作するときは、適切なエラー処理を実装します。

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

実稼働アプリケーションの場合は、ログ記録を設定し、適切なエラー処理パターンを実装することを検討してください。