C#でExcelファイルを読み書きするためのガイド

This article was translated from English: Does it need improvement?
Translated
View the article in English

Iron SoftwareのIronXLソフトウェア・ライブラリを使用すれば、C#やその他すべての.NET言語でExcel(XLS、XLSX、CSV)ファイルを簡単に読み、作成することができます。

IronXLはサーバーにExcel Interopをインストールする必要がありません。 IronXL は、Microsoft.Office.Interop.Excel よりも高速で直感的な API を提供します。

IronXLは以下のプラットフォームで動作します:

  • WindowsおよびAzureのための.NET Framework 4.6.2以上
  • Windows、Linux、MacOS、およびAzure向けの.NET Core 2以降
  • .NET 5、.NET 6、.NET 7、.NET 8、Mono、Maui、そしてXamarin

IronXLをインストール

まずは、NuGet パッケージを使用するか、またはDLL をダウンロードして、IronXL をインストールします。 IronXLのクラスはIronXL名前空間にあります。

IronXLをインストールする最も簡単な方法は、Visual-StudioのNuGetパッケージマネージャーを使用することです。

パッケージ名はIronXL.Excelです。

Install-Package IronXL.Excel

https://www.nuget.org/packages/ironxl.excel/

Excelドキュメントの読み取り

IronXLを使用すると、Excelファイルからのデータ抽出はわずか数行のコードで行うことができます。

:path=/static-assets/excel/content-code-examples/get-started/get-started-1.cs
using IronXL;

// Supported spreadsheet formats for reading include: XLSX, XLS, CSV and TSV
WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Select cells easily in Excel notation and return the calculated value, date, text or formula
int cellValue = workSheet["A2"].IntValue;

// Read from Ranges of cells elegantly.
foreach (var cell in workSheet["A2:B10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}
Imports IronXL

' Supported spreadsheet formats for reading include: XLSX, XLS, CSV and TSV
Private workBook As WorkBook = WorkBook.Load("data.xlsx")
Private workSheet As WorkSheet = workBook.WorkSheets.First()

' Select cells easily in Excel notation and return the calculated value, date, text or formula
Private cellValue As Integer = workSheet("A2").IntValue

' Read from Ranges of cells elegantly.
For Each cell In workSheet("A2:B10")
	Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next cell
$vbLabelText   $csharpLabel

新しいExcelドキュメントの作成

IronXLは、C#またはVB.NETを使用してExcelドキュメントを簡単かつ迅速に生成するためのインターフェースを提供します。

:path=/static-assets/excel/content-code-examples/get-started/get-started-2.cs
using IronXL;

// Create new Excel WorkBook document.
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
workBook.Metadata.Author = "IronXL";

// Add a blank WorkSheet
WorkSheet workSheet = workBook.CreateWorkSheet("main_sheet");

// Add data and styles to the new worksheet
workSheet["A1"].Value = "Hello World";
workSheet["A2"].Style.BottomBorder.SetColor("#ff6600");
workSheet["A2"].Style.BottomBorder.Type = IronXL.Styles.BorderType.Double;

// Save the excel file
workBook.SaveAs("NewExcelFile.xlsx");
Imports IronXL

' Create new Excel WorkBook document.
Private workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
workBook.Metadata.Author = "IronXL"

' Add a blank WorkSheet
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("main_sheet")

' Add data and styles to the new worksheet
workSheet("A1").Value = "Hello World"
workSheet("A2").Style.BottomBorder.SetColor("#ff6600")
workSheet("A2").Style.BottomBorder.Type = IronXL.Styles.BorderType.Double

' Save the excel file
workBook.SaveAs("NewExcelFile.xlsx")
$vbLabelText   $csharpLabel

CSV、XLS、XLSX、JSON、またはXMLとしてエクスポート

IronXLはまた、さまざまな一般的な構造化スプレッドシート形式にデータを保存またはエクスポートすることができます。

:path=/static-assets/excel/content-code-examples/get-started/get-started-3.cs
// Export to many formats with fluent saving
workSheet.SaveAs("NewExcelFile.xls");
workSheet.SaveAs("NewExcelFile.xlsx");
workSheet.SaveAsCsv("NewExcelFile.csv");
workSheet.SaveAsJson("NewExcelFile.json");
workSheet.SaveAsXml("NewExcelFile.xml");
' Export to many formats with fluent saving
workSheet.SaveAs("NewExcelFile.xls")
workSheet.SaveAs("NewExcelFile.xlsx")
workSheet.SaveAsCsv("NewExcelFile.csv")
workSheet.SaveAsJson("NewExcelFile.json")
workSheet.SaveAsXml("NewExcelFile.xml")
$vbLabelText   $csharpLabel

セルおよび範囲のスタイリング

IronXL.Range.Styleオブジェクトを使用して、Excelのセルや範囲に書式を適用することができます。

:path=/static-assets/excel/content-code-examples/get-started/get-started-4.cs
// Set cell's value and styles
workSheet["A1"].Value = "Hello World";
workSheet["A2"].Style.BottomBorder.SetColor("#ff6600");
workSheet["A2"].Style.BottomBorder.Type = IronXL.Styles.BorderType.Double;
' Set cell's value and styles
workSheet("A1").Value = "Hello World"
workSheet("A2").Style.BottomBorder.SetColor("#ff6600")
workSheet("A2").Style.BottomBorder.Type = IronXL.Styles.BorderType.Double
$vbLabelText   $csharpLabel

範囲の並べ替え

IronXLを使用すると、Rangeオブジェクトを利用してExcelのセル範囲を簡単にソートできます。

:path=/static-assets/excel/content-code-examples/get-started/get-started-5.cs
using IronXL;

WorkBook workBook = WorkBook.Load("test.xls");
WorkSheet workSheet = workBook.WorkSheets.First();

// This is how we get range from Excel worksheet
Range range = workSheet["A2:A8"];

// Sort the range in the sheet
range.SortAscending();
workBook.Save();
Imports IronXL

Private workBook As WorkBook = WorkBook.Load("test.xls")
Private workSheet As WorkSheet = workBook.WorkSheets.First()

' This is how we get range from Excel worksheet
Private range As Range = workSheet("A2:A8")

' Sort the range in the sheet
range.SortAscending()
workBook.Save()
$vbLabelText   $csharpLabel

数式の編集

Excelの数式を修正するには、「=」記号で始まる値を割り当てるだけです。 数式は即座に計算されます。

:path=/static-assets/excel/content-code-examples/get-started/get-started-6.cs
// Set a formula
workSheet["A1"].Value = "=SUM(A2:A10)";

// Get the calculated value
decimal sum = workSheet["A1"].DecimalValue;
' Set a formula
workSheet("A1").Value = "=SUM(A2:A10)"

' Get the calculated value
Dim sum As Decimal = workSheet("A1").DecimalValue
$vbLabelText   $csharpLabel

なぜIronXLを選ぶべきですか?

IronXLは、.NETでExcelドキュメントの読み書きができる開発者に優しいAPIを提供しています。

サーバーにMicrosoft ExcelまたはExcel Interopをインストールする必要がないため、Excelファイルの処理が高速で軽量、かつ手間がかかりません。

これから進む

さらなる機能と能力を探るために、MSDNドキュメントに類似した形式の.NET APIリファレンスを確認することをお勧めします。