フッターコンテンツにスキップ
IRONXLの使用

C#でStreamReaderを使用してExcelファイルを読み取る代替方法 - IronXL

C#開発者の多くは、Excelシートファイルを読もうとするときに共通の課題に遭遇します。テキストファイルでは完璧に動作する信頼できるStreamReaderが、Excelドキュメントでは不思議なことに失敗するのです。 C#でStreamReaderを使ってExcelファイルを読もうとしたときに、文字化けや例外が発生したことがある人は、あなただけではありません。 このチュートリアルでは、StreamReaderがExcelファイルを直接扱えない理由を説明し、Excel InteropなしでIronXLを使用した適切な解決方法を示します。

Excelで開くことができるCSVファイルは、StreamReaderで問題なく動作するため、しばしば混乱が生じます。 しかし、真のExcelファイル(XLSX, XLS)は根本的に異なるアプローチが必要です。 この違いを理解することで、デバッグに時間を節約し、タスクに最適なツールを見つける事ができます。

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 1 - IronXL.

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

StreamReaderはプレーンテキストファイル用に設計されており、指定されたエンコーディングを使用して文字データを行ごとに読み取ります。 Excel ファイルは、スプレッドシートのように見えますが、実際には複雑なバイナリまたは ZIP 圧縮された XML 構造であり、StreamReader では解釈できません。

static void Main(string[] args)
{
    // This code will NOT work - demonstrates the problem
    using (StreamReader reader = new StreamReader("ProductData.xlsx"))
    {
        string content = reader.ReadLine(); // read data
        Console.WriteLine(content); // Outputs garbled binary data
    }
}
static void Main(string[] args)
{
    // This code will NOT work - demonstrates the problem
    using (StreamReader reader = new StreamReader("ProductData.xlsx"))
    {
        string content = reader.ReadLine(); // read data
        Console.WriteLine(content); // Outputs garbled binary data
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

このプログラムのクラスコードスニペットを実行すると、スプレッドシートデータを見る代わりに、"PK♥♦"などのバイナリの未知データや類似のシステム文字が表示されます。 XLSXファイルは、複数のXMLファイルを含むZIPアーカイブであり、XLSファイルは独自のバイナリフォーマットを使用します。 StreamReaderはプレーンテキストを想定しており、これらの複雑な構造を文字として解釈しようとするため、意味のない出力になってしまいます。

サンプル入力

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 2 - Excel Input.

出力

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 3 - コンソール出力

最新のExcelファイル(XLSX)は複数のコンポーネントを含みます:ワークシート、スタイル、共有文字列、関連性など、すべてが一緒にパッケージ化されています。 この複雑さは、Excelファイル構造を理解する専門的なライブラリが必要であり、それがIronXLにつながります。

IronXLでExcelファイルを読み取る方法は?

IronXLは、C#でExcelファイルを読み込むための簡単なソリューションを提供します。 StreamReaderとは異なり、IronXLはExcelの内部構造を理解し、データにアクセスするための直感的な方法を提供します。 ライブラリはWindows、Linux、macOS、およびDockerコンテナをサポートしており、現代のクロスプラットフォームアプリケーションに最適です。

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 4 - Cross Platform.

まず、NuGetパッケージマネージャーを介してIronXLをインストールします:

Install-Package IronXL.Excel
Install-Package IronXL.Excel
SHELL

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 5 - インストール

適切にExcelファイルを読み取る方法は以下の通りです:

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}
using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

このコードはあなたのExcelファイルを成功裏に読み込み、セルの値にアクセスできるようにします。 WorkBook.Loadメソッドは、ファイル形式(XLSX、XLS、XLSM、CSV)を自動的に検出し、すべての複雑な解析を内部で処理します。 "A1"や"A1:C5"のようなExcelに馴染みのある表記を使用してセルにアクセスでき、Excelに詳しい人には直感的なコードになります。

メモリストリームからExcelを読み取る方法?

実際のアプリケーションでは、ディスクファイルではなくストリームからExcelファイルを処理する必要があることが多いです。 一般的なシナリオには、Webアップロードの処理、データベースからのファイルの取得、クラウドストレージからのデータの処理が含まれます。 IronXLはこれらの状況をエレガントに処理します:

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}
using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

WorkBook.FromStreamメソッドは、MemoryStreamFileStream、またはネットワーク ストリームであるかどうかにかかわらず、任意のストリーム タイプを受け入れます。 これにより、Excelファイルをディスクに保存することなく、さまざまなソースから処理する柔軟性が可能になります。この例では、ワークシートデータをデータテーブルに変換することもデモしており、データベースやデータバインディングシナリオとシームレスに統合されます。

出力

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 6 - MemoryStream OutputからExcelを読み込む

データを読み取るためにobject senderを使用するタイミング?

このコードがイベント駆動型プログラミング(たとえば、WindowsフォームやASP.NETでファイルアップロードボタンを処理する)で使用される場合、1つのメソッドのシグネチャには、オブジェクトsenderEventArgs eのようなパラメータが含まれることがよくあります。 このコンテキストは、Excelの処理ロジックが正しくUIまたはサービスのイベントに関連付けられることを保証します。

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 7 - Features.

ExcelとCSVの間で変換する方法?

StreamReaderはCSVファイルを扱うことができますが、ExcelとCSV形式の間で変換する必要があることがよくあります。 IronXLはこの変換を簡単にします:

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");
using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

これらの変換は、ファイル形式を変更しながらデータを保護します。 ExcelをCSVに変換する際、IronXLはデフォルトで最初のワークシートをフラット化しますが、エクスポートするワークシートを指定することもできます。 CSVからExcelへの変換は、データ型を保持し、今後のフォーマットおよび数式の追加を可能にする適切にフォーマットされたスプレッドシートを作成します。

結論

StreamReaderがExcelファイルを処理できないのは、プレーンテキストとExcelの複雑なファイル構造の根本的な違いに起因しています。 StreamReaderはCSVやその他のテキスト形式には完璧に機能しますが、真のExcelファイルにはバイナリとXML構造を理解するIronXLのような特殊なライブラリが必要です。

IronXLは直感的なAPI、包括的な形式サポート、シームレスなストリーム処理機能を備えたエレガントな解決策を提供します。 ウェブアプリケーション、デスクトップソフトウェア、クラウドサービスの構築に関わらず、IronXLはすべてのプラットフォームでExcelファイルを確実に処理します。

Alternative to Read Excel File Using StreamReader in C# - IronXL: Image 8 - Licensing.

Excelファイルを適切に扱い始める準備はできていますか? IronXLの無料トライアルをダウンロードし、C#アプリケーションでのExcel処理を体験してください。 本番環境への導入については、プロジェクトのニーズに最適なIronXLライセンスオプションをご検討ください。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。