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

StreamReader Excel ファイルを読み取れないのはなぜですか?

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

using System;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        // This code will NOT work - demonstrates the problem
        try
        {
            using (StreamReader reader = new StreamReader("ProductData.xlsx"))
            {
                string content = reader.ReadLine(); // read data
                Console.WriteLine(content); // Outputs garbled binary data
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

using System;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        // This code will NOT work - demonstrates the problem
        try
        {
            using (StreamReader reader = new StreamReader("ProductData.xlsx"))
            {
                string content = reader.ReadLine(); // read data
                Console.WriteLine(content); // Outputs garbled binary data
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

このコード スニペットを実行すると、スプレッドシートのデータが表示される代わりに、"PK♥♦"などのバイナリ文字や類似の記号が表示されます。 これは、 XLSX ファイルは複数の XML ファイルを含む ZIP アーカイブであるのに対し、XLS ファイルは独自のバイナリ形式を使用するために発生します。 StreamReaderはプレーンテキストを想定しており、これらの複雑な構造を文字として解釈しようとするため、意味のない出力になってしまいます。 コンテナ化されたアプリケーションの場合、このバイナリ データによってエンコードの問題や予期しないクラッシュが発生する可能性もあります。

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

IronXL は、C# で Excel ファイルを読み取るための簡単なソリューションを提供します。 StreamReaderとは異なり、IronXLはExcelの内部構造を理解し、データにアクセスするための直感的な方法を提供します。 このライブラリは、Windows 、 Linux 、 macOS 、 Docker コンテナをサポートしているため、最新のクロスプラットフォーム アプリケーションに最適です。 軽量で依存関係が最小限であるため、コンテナ化されたデプロイメントに最適です。

! Windows、Linux、macOS、Docker、Azure、AWS 環境における .NET の互換性を示すクロスプラットフォーム サポート図

Install-Package IronXL.Excel

# Add to your Dockerfile
RUN dotnet add package IronXL.Excel --version 2024.12.5

using IronXL;
using System;
using System.Linq;

class ExcelReader
{
    public static void ReadExcelData(string filePath)
    {
        try
        {
            // Load the Excel file
            WorkBook workbook = WorkBook.Load(filePath);
            WorkSheet worksheet = workbook.DefaultWorkSheet;

            // Read specific cell values with null checking
            var cellA1 = worksheet["A1"];
            if (cellA1 != null)
            {
                string cellValue = cellA1.StringValue;
                Console.WriteLine($"Cell A1 contains: {cellValue}");
            }

            // Read a range of cells with LINQ
            var range = worksheet["A1:C5"];
            var nonEmptyCells = range.Where(cell => !cell.IsEmpty);

            foreach (var cell in nonEmptyCells)
            {
                Console.WriteLine($"{cell.AddressString}: {cell.Text}");
            }

            // Get row and column counts for validation
            int rowCount = worksheet.RowCount;
            int columnCount = worksheet.ColumnCount;
            Console.WriteLine($"Worksheet dimensions: {rowCount} rows × {columnCount} columns");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error reading Excel file: {ex.Message}");
            // Log to your monitoring system
        }
    }
}

using IronXL;
using System;
using System.Linq;

class ExcelReader
{
    public static void ReadExcelData(string filePath)
    {
        try
        {
            // Load the Excel file
            WorkBook workbook = WorkBook.Load(filePath);
            WorkSheet worksheet = workbook.DefaultWorkSheet;

            // Read specific cell values with null checking
            var cellA1 = worksheet["A1"];
            if (cellA1 != null)
            {
                string cellValue = cellA1.StringValue;
                Console.WriteLine($"Cell A1 contains: {cellValue}");
            }

            // Read a range of cells with LINQ
            var range = worksheet["A1:C5"];
            var nonEmptyCells = range.Where(cell => !cell.IsEmpty);

            foreach (var cell in nonEmptyCells)
            {
                Console.WriteLine($"{cell.AddressString}: {cell.Text}");
            }

            // Get row and column counts for validation
            int rowCount = worksheet.RowCount;
            int columnCount = worksheet.ColumnCount;
            Console.WriteLine($"Worksheet dimensions: {rowCount} rows × {columnCount} columns");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error reading Excel file: {ex.Message}");
            // Log to your monitoring system
        }
    }
}

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

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

using IronXL;
using System.IO;
using System.Data;
using System.Threading.Tasks;

public class StreamProcessor
{
    // Async method for container health checks
    public async Task<bool> ProcessExcelStreamAsync(byte[] fileBytes)
    {
        try
        {
            using (MemoryStream stream = new MemoryStream(fileBytes))
            {
                // Load from stream asynchronously
                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 DataTable for database operations
                var dataTable = worksheet.ToDataTable(true); // true = use first row as headers

                // Validate data integrity
                if (dataTable.Rows.Count == 0)
                {
                    Console.WriteLine("Warning: No data rows found");
                    return false;
                }

                Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
                Console.WriteLine($"Columns: {string.Join(", ", dataTable.Columns.Cast<DataColumn>().Select(c => c.ColumnName))}");

                // Example: Process data for container metrics
                foreach (DataRow row in dataTable.Rows)
                {
                    // Your processing logic here
                    await ProcessRowAsync(row);
                }

                return true;
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Stream processing error: {ex.Message}");
            return false;
        }
    }

    private async Task ProcessRowAsync(DataRow row)
    {
        // Simulate async processing
        await Task.Delay(10);
    }
}

using IronXL;
using System.IO;
using System.Data;
using System.Threading.Tasks;

public class StreamProcessor
{
    // Async method for container health checks
    public async Task<bool> ProcessExcelStreamAsync(byte[] fileBytes)
    {
        try
        {
            using (MemoryStream stream = new MemoryStream(fileBytes))
            {
                // Load from stream asynchronously
                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 DataTable for database operations
                var dataTable = worksheet.ToDataTable(true); // true = use first row as headers

                // Validate data integrity
                if (dataTable.Rows.Count == 0)
                {
                    Console.WriteLine("Warning: No data rows found");
                    return false;
                }

                Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
                Console.WriteLine($"Columns: {string.Join(", ", dataTable.Columns.Cast<DataColumn>().Select(c => c.ColumnName))}");

                // Example: Process data for container metrics
                foreach (DataRow row in dataTable.Rows)
                {
                    // Your processing logic here
                    await ProcessRowAsync(row);
                }

                return true;
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Stream processing error: {ex.Message}");
            return false;
        }
    }

    private async Task ProcessRowAsync(DataRow row)
    {
        // Simulate async processing
        await Task.Delay(10);
    }
}

WorkBook.FromStream メソッドは、 MemoryStream 、 FileStream 、ネットワーク ストリームなど、あらゆるストリーム タイプを受け入れます。 この柔軟性により、様々なソースからのExcelファイルを、事前にディスクに保存することなく処理できます。また、この例では、ワークシートのデータをDataTableに変換する方法も示しています。DataTableは、データベースやデータバインディングのシナリオとシームレスに統合されます。 ここで示した非同期パターンは、コンテナのヘルスチェックや準備状況のプローブに最適です。

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

StreamReader CSV ファイルを処理できますが、多くの場合、Excel 形式と CSV 形式の間で変換する必要があります。 IronXL は、実稼働環境向けに最適化された組み込みメソッドを使用して、この変換を簡単にします。

using IronXL;
using System;
using System.IO;

public class FormatConverter
{
    public static void ConvertExcelFormats()
    {
        try
        {
            // Load an Excel file and save as CSV with options
            WorkBook workbook = WorkBook.Load("data.xlsx");

            // Save with UTF-8 encoding for international character support
            workbook.SaveAsCsv("output.csv", ";"); // Use semicolon as delimiter

            // Load a CSV file with custom settings
            WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv", ",", "UTF-8");
            csvWorkbook.SaveAs("output.xlsx", FileFormat.XLSX);

            // Export specific worksheet to CSV
            if (workbook.WorkSheets.Count > 0)
            {
                WorkSheet worksheet = workbook.WorkSheets[0];
                worksheet.SaveAsCsv("worksheet1.csv");

                // Advanced: Export only specific range
                var dataRange = worksheet["A1:D100"];
                // Process range data before export
                foreach (var cell in dataRange)
                {
                    if (cell.IsNumeric)
                    {
                        // Apply formatting for CSV output
                        cell.FormatString = "0.00";
                    }
                }
            }

            Console.WriteLine("Conversion completed successfully");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Conversion error: {ex.Message}");
            throw; // Re-throw for container orchestrator handling
        }
    }
}

using IronXL;
using System;
using System.IO;

public class FormatConverter
{
    public static void ConvertExcelFormats()
    {
        try
        {
            // Load an Excel file and save as CSV with options
            WorkBook workbook = WorkBook.Load("data.xlsx");

            // Save with UTF-8 encoding for international character support
            workbook.SaveAsCsv("output.csv", ";"); // Use semicolon as delimiter

            // Load a CSV file with custom settings
            WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv", ",", "UTF-8");
            csvWorkbook.SaveAs("output.xlsx", FileFormat.XLSX);

            // Export specific worksheet to CSV
            if (workbook.WorkSheets.Count > 0)
            {
                WorkSheet worksheet = workbook.WorkSheets[0];
                worksheet.SaveAsCsv("worksheet1.csv");

                // Advanced: Export only specific range
                var dataRange = worksheet["A1:D100"];
                // Process range data before export
                foreach (var cell in dataRange)
                {
                    if (cell.IsNumeric)
                    {
                        // Apply formatting for CSV output
                        cell.FormatString = "0.00";
                    }
                }
            }

            Console.WriteLine("Conversion completed successfully");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Conversion error: {ex.Message}");
            throw; // Re-throw for container orchestrator handling
        }
    }
}

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

結論

StreamReaderがExcelファイルを処理できないのは、プレーンテキストとExcelの複雑なファイル構造の根本的な違いに起因しています。 StreamReader CSV やその他のテキスト形式では完璧に動作しますが、真の Excel ファイルには、内部のバイナリおよび XML 構造を理解するIronXLのような特殊なライブラリが必要です。 コンテナ化されたアプリケーションを管理するDevOpsチームにとって、信頼性の高いデプロイメント パイプラインを維持するためには、適切なライブラリを選択することが重要です。

IronXL は、直感的な API、包括的な形式のサポート、シームレスなストリーム処理機能を備えた優れたソリューションを提供します。 Web アプリケーション、デスクトップ ソフトウェア、クラウド サービスなどを構築する場合でも、IronXL はすべてのプラットフォームで Excel ファイルを確実に処理します。 コンテナフレンドリーな設計、最小限の依存関係、優れたパフォーマンス特性により、最新のDevOpsワークフローに最適です。

! IronXL ライセンスページには、Lite ($749)、Plus ($999)、Professional ($1,999)、Unlimited ($3,999) の永久ライセンスオプションが表示されています

Excelファイルを適切に扱い始める準備はできていますか？ IronXL の無料トライアルをダウンロードして、自分の環境でその機能を調べてください。 ライブラリには、コンテナ化された環境向けに特別に設計された包括的なドキュメント、コード例、およびデプロイメント ガイドが含まれています。