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

StreamReader Excel ファイルを読み込めないのはなぜですか？

StreamReader は、プレーンテキストファイル用に設計されており、指定されたエンコーディングを使用して文字データを1行ずつ読み取ります。 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コンテナをサポートしているため、最新のクロスプラットフォームアプリケーションに最適です。 その軽量性と最小限の依存関係により、コンテナ化されたデプロイメントに最適です。

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 メソッドは、FileStream、またはネットワーク ストリームなど、あらゆるストリーム タイプを受け入れます。 この柔軟性により、さまざまなソースからの Excel ファイルを、最初にディスクに保存することなく処理できます。この例では、ワークシートのデータを 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
        }
    }
}

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

結論

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

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

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