StreamReader の代わりに C# で Excel ファイルを読み取る方法

StreamReaderがExcelファイルを読めない理由は？

StreamReader はテキストベースのリーダーです。 指定されたエンコーディング（UTF-8、ASCIIなど）を使用して文字データを1行ずつ読み込み、バイナリ構造や圧縮アーカイブについては認識しません。 公式の.NET StreamReaderドキュメントには、このクラスは文字エンコードされたテキスト専用に設計されていることが明記されています。 Excel ファイルは、一見すると単純な表計算ソフトのように見えますが、実際には StreamReader が解釈できない複雑なバイナリまたは ZIP 圧縮された XML 構造です。

StreamReader で XLSX ファイルを開くと、実質的に ZIP アーカイブをプレーンテキストとして読み込もうとしていることになります。 その結果、スプレッドシートのデータではなく、バイナリノイズの羅列が生成されます。

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

Imports System.IO

' This code will NOT work -- demonstrates the problem
Using reader As New StreamReader("ProductData.xlsx")
    Dim content As String = reader.ReadLine()
    Console.WriteLine(content) ' Outputs garbled binary data like "PK♥♦"
End Using

このコードを実行すると、スプレッドシートの行が表示される代わりに、PK♥♦ のようなバイナリ文字や類似のノイズが表示されます。これは以下の理由で発生します。

• XLSXファイルは、ワークシート、スタイル、共有文字列、リレーションシップなど、複数のXMLファイルを含むZIPアーカイブです。 Open XML SDKのドキュメントには、この構造の詳細な解説が記載されています。
• XLSファイルは独自のバイナリ形式(BIFF - バイナリ交換ファイル形式)を使用します。
• StreamReader は読み取ったバイトに文字エンコーディングを適用するため、どちらの形式でも意味のない出力が生成されます。

.NETプロジェクトにIronXLをインストールするにはどうすればよいですか？

IronXLは、Microsoft ExcelがインストールされていなくてもExcelファイルの読み書きや作成ができる.NETライブラリです。 XLSX、XLS、XLSM、CSV、TSV形式をサポートし、Windows、Linux、macOS、およびDockerコンテナ上で動作します。

IronXLをインストールするには、 NuGetパッケージマネージャーコンソールまたは.NET CLIのいずれかを使用してください。 このパッケージはNuGetにIronXLとして公開されています。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

インストール後、ファイルに"using IronXL;"というディレクティブを追加すれば、Excelドキュメントを操作できるようになります。

詳細なインストール手順とNuGet の設定オプションについては、 IronXL NuGetインストールガイドを参照してください。 無料トライアルライセンスをご利用いただけますので、ご購入前にプロジェクトでIronXLを評価できます。

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

IronXLは、C#でExcelファイルを読み込むための直感的なAPIを提供します。 StreamReaderとは異なり、 IronXLはExcelの内部構造を理解し、行、列、セル値へのクリーンなアクセスを提供します。 IronXLのドキュメントには、サポートされているすべての操作に関する完全なAPIリファレンスが記載されています。

IronXLのトップレベルステートメントを使用してExcelファイルを読み込む方法は次のとおりです。

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

Imports IronXL

' Load the Excel file from disk
Dim workbook As WorkBook = WorkBook.Load("ProductData.xlsx")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Read a specific cell by address
Dim cellValue As String = worksheet("A1").StringValue
Console.WriteLine($"Cell A1 contains: {cellValue}")

' Iterate over a range of cells
For Each cell In worksheet("A1:C10")
    Console.WriteLine($"{cell.AddressString}: {cell.Text}")
Next

' Read a numeric value
Dim price As Decimal = worksheet("B2").DecimalValue
Console.WriteLine($"Price: {price:C}")

WorkBook.Load メソッドは、ファイル形式 (XLSX、XLS、XLSM、CSV) を自動的に検出し、複雑な解析をすべて処理します。 セルへのアクセスには、"A1" のような標準的な Excel 表記法、または "A1:C10" のような範囲指定を使用するため、スプレッドシートに慣れている人なら誰でもすぐにコードを読み取ることができます。

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("MultiSheet.xlsx")

' List all worksheets
For Each sheet As WorkSheet In workbook.WorkSheets
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}")
Next

' Access a sheet by name
Dim summary As WorkSheet = workbook.GetWorkSheet("Summary")
Dim totalRevenue As String = summary("B20").StringValue
Console.WriteLine($"Total Revenue: {totalRevenue}")

' Access a sheet by index
Dim firstSheet As WorkSheet = workbook.WorkSheets(0)
Dim lastRow As Integer = firstSheet.RowCount
Console.WriteLine($"Last row in first sheet: {lastRow}")

メモリ ストリームから Excel データを読み込むにはどうすればよいですか？

実際のアプリケーションでは、ディスクファイルではなくストリームからExcelファイルを処理する必要があることが多いです。 一般的なシナリオとしては、Webフォームからのファイルアップロードの処理、データベースのBLOB列からのワークブックの取得、クラウドストレージ(Azure Blob Storage、AWS S3)からダウンロードしたファイルの処理などが挙げられます。 IronXL は、これらのシナリオを WorkBook.FromStream を通じて処理します。

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

WorkBook.FromStream は、任意の Stream -- FileStream、またはネットワーク ストリームを受け入れます。 この柔軟性のおかげで、Excelデータを読み込むためだけに一時ファイルをディスクに書き込む必要は一切なくなります。 DataTable への変換は、SqlBulkCopy、データバインディングコントロール、およびレポートフレームワークと直接統合されます。

Excel形式とCSV形式の間でデータを変換するにはどうすればよいですか？

StreamReader は CSV ファイルを扱うことができますが、実際のアプリケーションでは、Excel と CSV 間でデータをやり取りする必要がある場合がよくあります。IronXLを使用すると、フォーマット変換が簡単になります。 ExcelデータをCSVファイルにエクスポートしたり、 CSVデータをワークブックにインポートしたりするのは、わずか数行のコードで可能です。

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

これらの変換処理は、コンテナ形式を変更しながらデータを保持します。 IronXLはExcelをCSVに変換する際、デフォルトで最初のワークシートをエクスポートします。 任意のシートを指定できます。 CSVファイルをExcelファイルに変換すると、適切な構造のワークブックが作成され、その後、書式設定、数式の追加、追加データの書き込みなどが可能になります。

IronXLを使ってExcelファイルを作成・フォーマットするにはどうすればよいですか？

Excelデータの読み込みは、ワークフローの一部に過ぎません。 多くのアプリケーションでは、新しいExcelファイルを作成し、書式設定を適用する必要がある。 IronXLは、フォント、色、罫線、数値形式、セル結合など、セルの書式設定をサポートしています。

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

Imports IronXL

' Create a new workbook and worksheet
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Report")

' Write headers with formatting
sheet("A1").Value = "Product"
sheet("B1").Value = "Units Sold"
sheet("C1").Value = "Revenue"

' Apply bold formatting to header row
sheet("A1:C1").Style.Font.Bold = True
sheet("A1:C1").Style.SetBackgroundColor("#4472C4")
sheet("A1:C1").Style.Font.Color = "#FFFFFF"

' Write data rows
Dim products As String() = {"Widget A", "Widget B", "Widget C"}
Dim units As Integer() = {120, 85, 210}
Dim revenues As Decimal() = {2400.0D, 1700.0D, 4200.0D}

For i As Integer = 0 To products.Length - 1
    sheet($"A{i + 2}").Value = products(i)
    sheet($"B{i + 2}").Value = units(i)
    sheet($"C{i + 2}").Value = revenues(i)
    sheet($"C{i + 2}").FormatString = "$#,##0.00"
Next

' Save the workbook
workbook.SaveAs("FormattedReport.xlsx")
Console.WriteLine("Report created successfully.")

既存のワークブックを読み込む機能と、新しいフォーマット済みファイルを作成する機能の両方を備えているため、 IronXLは.NETアプリケーション向けの完全なExcelソリューションと言えます。 サポートされている操作の詳細については、 IronXLの機能一覧ページをご覧ください。

IronXLを本番環境に導入する際のライセンス取得と展開方法は？

IronXLは開発およびテスト目的では無料で利用できます。 実運用で使用する場合は、ライセンスが必要です。 IronXLのライセンスオプションについては、製品ページをご覧ください。導入要件に応じて、開発者、チーム、組織の各ティアが用意されています。

購入後、 IronXLの呼び出しを行う前に、コードにライセンスキーを適用してください。

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Imports IronXl

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

または、デプロイ環境で環境変数 IRONXL_LICENSE_KEY を設定すれば、 IronXL が自動的にそれを認識します。 これは、コンテナ化されたデプロイメント（Docker、Kubernetes）や、キーをハードコーディングすることが許容されないクラウド環境において推奨されるアプローチです。

評価目的であれば、無料トライアルライセンスで全ての機能をご利用いただけるため、購入を決定する前に、お客様固有のワークロードに対してIronXLの性能を検証できます。 クレジットカード不要で無料トライアルを利用でき、すぐに有効になります。

Microsoft.Office.Interop.Excelなどの代替製品と比較して、 IronXLにはいくつかの導入上の利点があります。

• サーバーにMicrosoft Excelをインストールする必要はありません LinuxおよびDockerとの互換性 - クラウドネイティブアプリケーションにとって不可欠 COMオブジェクトのライフサイクル管理やアパートメントのスレッド処理に関する問題はありません。
• サーバー環境における起動速度の向上とメモリ使用量の削減
• サポートされているすべてのプラットフォームで一貫した動作

これらの特長により、 IronXLは、オンプレミス環境でもクラウド環境でも、本番環境でExcelファイルを処理する必要のあるあらゆる.NETアプリケーションにとって、実用的な選択肢となります。