C#でExcelファイルをインポートする方法

IronXLがExcelインポートに不可欠な主な機能とは？

Excelのインストールを必要とせずに、Excelファイルを開いて読み込み、XLS/CSV/TSV/XLSXファイルなどのさまざまなスプレッドシート形式からデータを検索できます。

• ExcelワークシートをXLS/XLSX/CSV/TSV/JSON、さらにはHTMLなど、複数の形式にエクスポートします。
• セキュリティ強化のため、XLSM/XLTX/XLSXファイルをパスワードで暗号化および復号化します。
• ExcelシートをSystem.Data.DataSetおよびSystem.Data.DataTableオブジェクトとしてインポートし、シームレスなデータベース統合を実現します。
• Excelファイルの数式は、シートが編集されるたびに自動的に再計算されます。
• 直感的なセル範囲設定と、範囲を選択するための簡単な構文
• 組み込みメソッドを使用して、セル範囲、列、行を並べ替えます。 *フォントのカスタマイズ、背景色、枠線と配置、番号付け形式など、包括的なセルスタイル設定が可能

Excelファイルのインポートを開始する前に必要なものは何ですか？

C#でIronXLを使用してExcelファイルを読み込むには、以下のコンポーネントがコンピュータにインストールされていることを確認してください。

1. Visual Studio - これは、C# .NETアプリケーションを開発するための公式IDEです。 Visual Studio は、Excel ファイルの操作を容易にする優れたサポートとデバッグ ツールを提供します。 Visual Studio はMicrosoft のウェブサイトからダウンロードしてインストールできます。 コミュニティ版は無料で、ほとんどの開発ニーズを満たすのに十分です。

2. IronXL - これは、C# で指定されたパスにある Excel シートを操作するのに役立つライブラリです。 使用する前に、C#プログラムにインストールする必要があります。 IronXLは、 NuGetのWebサイトから簡単にダウンロードできるほか、Visual Studioツールの"NuGetパッケージの管理"インターフェースから直接インストールすることもできます。 手動でインストールしたい場合は、 .NET Excel DLLファイルを直接ダウンロードすることもできます。

本番環境への導入には、ライセンスキーを適用してウォーターマークを削除し、すべての機能を有効にする必要があります。 試用版を使用すれば、開発やテストを行うことができます。

コードにどの名前空間を追加すべきですか？

Visual StudioとIronXLがインストールされたら、 IronXLアセンブリを参照して、ソースコード内でIronXLを使用します。 新しいプロジェクトでIronXLの機能が使用される場所のファイルの先頭に以下の行を追加します。

using IronXL;

using IronXL;

Imports IronXL

この単一の名前空間インポートにより、Excelの操作に必要なすべてのコア機能にアクセスできます。 グラフや条件付き書式などの特定のExcel機能を使用する場合は、 IronXLライブラリから追加の名前空間をインポートする必要がある場合があります。

Excelファイルを読み込んで開くにはどうすればよいですか？

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

// You can also load from a stream
using (var stream = File.OpenRead("test.xlsx"))
{
    WorkBook streamWorkbook = WorkBook.Load(stream);
}

// Or load CSV files with custom delimiters
WorkBook csvWorkbook = WorkBook.LoadCSV("data.csv", delimiter: ",");

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

// You can also load from a stream
using (var stream = File.OpenRead("test.xlsx"))
{
    WorkBook streamWorkbook = WorkBook.Load(stream);
}

// Or load CSV files with custom delimiters
WorkBook csvWorkbook = WorkBook.LoadCSV("data.csv", delimiter: ",");

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

' You can also load from a stream
Using stream = File.OpenRead("test.xlsx")
    Dim streamWorkbook As WorkBook = WorkBook.Load(stream)
End Using

' Or load CSV files with custom delimiters
Dim csvWorkbook As WorkBook = WorkBook.LoadCSV("data.csv", delimiter:=",")

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

// Or access by worksheet name
WorkSheet namedSheet = workbook.GetWorkSheet("Sheet1");

// Or by index (zero-based)
WorkSheet indexedSheet = workbook.WorkSheets[0];

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

// Or access by worksheet name
WorkSheet namedSheet = workbook.GetWorkSheet("Sheet1");

// Or by index (zero-based)
WorkSheet indexedSheet = workbook.WorkSheets[0];

' Get the first worksheet
Dim sheet As WorkSheet = workbook.WorkSheets.First()

' Or access by worksheet name
Dim namedSheet As WorkSheet = workbook.GetWorkSheet("Sheet1")

' Or by index (zero-based)
Dim indexedSheet As WorkSheet = workbook.WorkSheets(0)

インポート後に特定のセル値を読み取るにはどうすればよいですか？

Excelファイルがインポートされると、データの読み込み準備が整います。 IronXLを使用してC#でExcelデータを読み取るのは非常に簡単です。 Excelのセル値を読み取るには、標準的なExcel表記("A1"、"B2"など)でセル参照番号を指定するだけで済みます。 このライブラリは、想定されるデータ型に応じて、セル値にアクセスするための複数の方法を提供します。

次のコードは、参照番号 "C2" のセルの値を取得します。

// Select cells easily in Excel-notation and return the value
int cellValue = sheet["C2"].IntValue;

// Display the value
Console.WriteLine(cellValue);

// You can also access different data types
string textValue = sheet["A2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
double doubleValue = sheet["C2"].DoubleValue;
DateTime dateValue = sheet["D2"].DateTimeValue;
bool boolValue = sheet["E2"].BoolValue;

// Check if cell is empty
bool isEmpty = sheet["F2"].IsEmpty;

// Select cells easily in Excel-notation and return the value
int cellValue = sheet["C2"].IntValue;

// Display the value
Console.WriteLine(cellValue);

// You can also access different data types
string textValue = sheet["A2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
double doubleValue = sheet["C2"].DoubleValue;
DateTime dateValue = sheet["D2"].DateTimeValue;
bool boolValue = sheet["E2"].BoolValue;

// Check if cell is empty
bool isEmpty = sheet["F2"].IsEmpty;

' Select cells easily in Excel-notation and return the value
Dim cellValue As Integer = sheet("C2").IntValue

' Display the value
Console.WriteLine(cellValue)

' You can also access different data types
Dim textValue As String = sheet("A2").StringValue
Dim decimalValue As Decimal = sheet("C2").DecimalValue
Dim doubleValue As Double = sheet("C2").DoubleValue
Dim dateValue As DateTime = sheet("D2").DateTimeValue
Dim boolValue As Boolean = sheet("E2").BoolValue

' Check if cell is empty
Dim isEmpty As Boolean = sheet("F2").IsEmpty

出力は以下の通りです。

C#でExcelファイルの読み込みに成功した後のデバッグコンソール出力。 プログラムの実行が完了し、終了するにはユーザーからの入力を待っています。

それでは、開いたExcelファイル内のセル範囲からデータを読み込みましょう。IronXLを使えば、使い慣れたExcelの表記法でセル範囲を簡単に操作できます。 コードは次の通りです：

// Read from a range of cells elegantly.
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// You can also work with entire rows or columns
var row = sheet.GetRow(2); // Get row 3 (0-indexed)
foreach (var cell in row)
{
    Console.WriteLine($"Row cell value: {cell.Value}");
}

// Or get a column
var column = sheet.GetColumn(0); // Get column A
foreach (var cell in column)
{
    Console.WriteLine($"Column A value: {cell.Value}");
}

// Read from a range of cells elegantly.
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// You can also work with entire rows or columns
var row = sheet.GetRow(2); // Get row 3 (0-indexed)
foreach (var cell in row)
{
    Console.WriteLine($"Row cell value: {cell.Value}");
}

// Or get a column
var column = sheet.GetColumn(0); // Get column A
foreach (var cell in column)
{
    Console.WriteLine($"Column A value: {cell.Value}");
}

' Read from a range of cells elegantly.
For Each cell In sheet("A2:A6")
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next

' You can also work with entire rows or columns
Dim row = sheet.GetRow(2) ' Get row 3 (0-indexed)
For Each cell In row
    Console.WriteLine($"Row cell value: {cell.Value}")
Next

' Or get a column
Dim column = sheet.GetColumn(0) ' Get column A
For Each cell In column
    Console.WriteLine($"Column A value: {cell.Value}")
Next

コードは非常にシンプルでクリーンでクリアです。 セル範囲は、foreach ループで示されているような簡単な構文で参照できます。sheet["A2:A6"] また、各セルを反復してその値を取得できます。 コンソール出力のA列の2行目から6行目までの名前が表示されます。

C# を使用して名前を含む Excel セル範囲 (A2:A6) の読み取りが成功したことを示すコンソール出力

セル値の読み書きに関する詳細については、 C# で Excel ファイルを読み込む例に関するこちらのチュートリアルを参照してください。 数式の適用や名前付き範囲の操作など、高度な機能も利用できます。

ワークシート全体を一度にインポートするにはどうすればよいですか？

WorkBook workbook = WorkBook.Load("test.xlsx");
WorkSheet sheet = workbook.WorkSheets.First();

// Traverse all rows of Excel WorkSheet
for (int i = 0; i < sheet.Rows.Count(); i++)
{
    // Traverse all columns of specific Row
    for (int j = 0; j < sheet.Columns.Count(); j++)
    {
        // Get the values
        string val = sheet.Rows[i].Columns[j].Value.ToString();
        Console.Write("{0}\t", val);
    }
    Console.WriteLine();
}

// Alternative method using LINQ for more efficient processing
var allData = sheet.Rows.SelectMany(row => 
    row.Columns.Select(col => col.Value?.ToString() ?? "")).ToList();

WorkBook workbook = WorkBook.Load("test.xlsx");
WorkSheet sheet = workbook.WorkSheets.First();

// Traverse all rows of Excel WorkSheet
for (int i = 0; i < sheet.Rows.Count(); i++)
{
    // Traverse all columns of specific Row
    for (int j = 0; j < sheet.Columns.Count(); j++)
    {
        // Get the values
        string val = sheet.Rows[i].Columns[j].Value.ToString();
        Console.Write("{0}\t", val);
    }
    Console.WriteLine();
}

// Alternative method using LINQ for more efficient processing
var allData = sheet.Rows.SelectMany(row => 
    row.Columns.Select(col => col.Value?.ToString() ?? "")).ToList();

Dim workbook As WorkBook = WorkBook.Load("test.xlsx")
Dim sheet As WorkSheet = workbook.WorkSheets.First()

' Traverse all rows of Excel WorkSheet
For i As Integer = 0 To sheet.Rows.Count() - 1
    ' Traverse all columns of specific Row
    For j As Integer = 0 To sheet.Columns.Count() - 1
        ' Get the values
        Dim val As String = sheet.Rows(i).Columns(j).Value.ToString()
        Console.Write("{0}" & vbTab, val)
    Next
    Console.WriteLine()
Next

' Alternative method using LINQ for more efficient processing
Dim allData = sheet.Rows.SelectMany(Function(row) 
    row.Columns.Select(Function(col) If(col.Value?.ToString(), ""))).ToList()

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

// Process data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

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

// Process data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

' Convert worksheet to DataTable for easier manipulation
Dim dataTable As DataTable = sheet.ToDataTable(True) ' True = first row contains headers

' Process data using DataTable methods
For Each row As DataRow In dataTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}" & vbTab)
    Next
    Console.WriteLine()
Next

Excelファイルをインポートした後の次のステップは何ですか？

この記事では、Microsoft Excelがインストールされていない環境で、C#を使用してExcelファイルをインポートおよび読み込む方法を解説しました。 この記事では、Excelスプレッドシートからデータを読み取るための複数の方法について解説しており、個々のセルからワークシート全体までを網羅しています。 IronXLを使えば、Excelをインストールすることなく、C#でExcelファイルを作成することもできます。

Excelデータのインポートが成功したら、以下の追加機能も試してみてください。

*データ処理*：セル範囲の並べ替え、フィルターの適用、行と列のグループ化 データ検証：データ整合性を確保するために、 データ検証ルールを実装します。 書式設定：セルのスタイル設定、条件付き書式設定、または数値書式設定を適用します。 グラフとビジュアル**：グラフを作成したり、画像を追加したりして、データの表示を強化します。 *セキュリティ：ワークブックまたは個々のワークシートにパスワード保護を設定する

IronXLはすべてのMicrosoft Excelドキュメント関連タスクのオールインワンソリューションを提供します。 数式計算、文字列や数値の並べ替え、トリミングと追加、検索と置換、セルの結合と結合解除、ファイルの保存など、さまざまな操作を実行できます。 セルの値を編集したり、セルのデータ形式を設定したり、スプレッドシートのデータを検証したりできます。 CSVファイルにも対応しており、Excelデータとのシームレスな連携を可能にします。

Enterpriseアプリケーションの場合は、 Dockerコンテナ、 Azure Functions 、 AWS Lambdaなど、さまざまなプラットフォームのデプロイオプションを検討してください。

IronXLは無料トライアルが利用可能で、商用利用のライセンスはLiteパッケージのみで、$799から取得できます。 このライブラリは、C#アプリケーションでExcelファイルの操作をすぐに始められるように、優れたドキュメント、チュートリアル、コード例を提供しています。