C#でIronXLを使用してMS Excelファイルのデータを簡単にインポート、読み取り、操作する方法

サンプル入力

How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 4 - Excel Input.

出力

How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 5 - Console Output.

ExcelのデータをC#オブジェクトに読み込むには？ 実際のアプリケーションでは、単一セルの値以上のものが必要です。 IronXLはデータセット全体をインポートし、使用可能なC#オブジェクトに変換することを得意としています。 [構造化データを含むExcelファイル](/tutorials/how-to-read-excel-file-csharp/)をインポートする必要がある場合、ライブラリは複数のアプローチを提供します。 ```cs // Load the Excel file WorkBook workBook = WorkBook.Load("ProductData.xlsx"); WorkSheet sheet = workBook.DefaultWorkSheet; // Read a range of cells var products = new List(); foreach (var row in sheet.Rows) { var product = new Product { Id = row.Columns[0].IntValue, Name = row.Columns[1].StringValue, Price = row.Columns[2].DecimalValue, IsAvailable = row.Columns[3].BoolValue }; products.Add(product); } foreach (var product in products) { Console.WriteLine($"Id: {product.Id}, Name: {product.Name}, Price: {product.Price}, Available: {product.IsAvailable}"); } ``` この例では、行を繰り返し処理し、Excelデータを強く型付けされたC#オブジェクトにマッピングする方法を示します。 IntValue、StringValue、DecimalValueのような型付きプロパティは、型変換を自動的に処理します。 このアプローチにより、手作業による解析が不要になり、異なるデータ型を扱う際のエラーを減らすことができます。[Stack Overflow](https://stackoverflow.com/questions/15793442/how-to-read-data-from-excel-file-using-c-sharp) の多くの開発者は、Excel データ インポートに対するこのタイプセーフ アプローチを高く評価しています。 ### 出力 [How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 6 - Object Output](/static-assets/excel/blog/csharp-import-excel/csharp-import-excel-6.webp). よりエレガントなデータアクセスのために、IronXLは範囲演算をサポートしています： ```cs // Read specific ranges of ProductData.xlsx file Range dataRange = sheet["A1:D5"]; // Calculate aggregates directly decimal sum = sheet["C1:C5"].Sum(); Console.WriteLine($"Sum of C1:C5: {sum}"); decimal max = sheet["C1:C5"].Max(c => c.DecimalValue); Console.WriteLine($"Max of C1:C5: {max}"); // Use LINQ for filtering var highValueOrders = dataRange .Where(cell => cell.DecimalValue > 100) .Select(cell => cell.Value) .ToList(); Console.WriteLine("High value orders (>100):"); // Print the high value orders to the console foreach (var order in highValueOrders) { Console.WriteLine(order); } ``` Rangeクラスは、複数のセルに同時にアクセスするコレクションのような機能を提供します。 LINQとの互換性は、開発者が使い慣れたC#パターンを使用してExcelデータをフィルタリング、変換、集計できることを意味します。 Sum()やMax()のような組み込みの集計メソッドは、最初にすべてのデータをメモリにロードすることなく、セル範囲に対して直接操作します。 ### 出力 [How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 7 - Range Output](/static-assets/excel/blog/csharp-import-excel/csharp-import-excel-7.webp). ## ExcelをDataTableに変換するには? DataTableの変換は、データベース操作とデータバインディングのシナリオに不可欠です。 IronXLは[ExcelからDataTable](/blog/using-ironxl/excel-to-datatable-csharp-tutorial/)への変換を効率的に処理する組み込みメソッドを提供します。この機能はExcelスプレッドシートをSQL Serverや他のデータベースにインポートする必要がある場合に特に便利です。 ```cs using System.Data; // Load Excel file WorkBook workBook = WorkBook.Load("inventory.xlsx"); // Select first Excel worksheet WorkSheet sheet = workBook.WorkSheets.First(); // Convert to DataTable with headers DataTable dataTable = sheet.ToDataTable(true); // The DataTable is ready for database operations using (SqlBulkCopy bulkCopy = new SqlBulkCopy(connectionString)) { bulkCopy.DestinationTableName = "Inventory"; bulkCopy.WriteToServer(dataTable); } ``` ToDataTable() メソッドは、最初の行にヘッダが含まれているかどうかを示す boolean パラメータを受け付けます。 Trueに設定すると、IronXLは自動的に最初の行の値をDataTableの列名として使用します。 このDataTableは、ADO.NET操作、Entity Framework、およびデータバインディングコントロールとシームレスに統合されています。 SqlBulkCopyに関するMicrosoftのドキュメントでは、このパターンがいかに効率的に大規模なデータのインポートを処理するかを示しています。 変換プロセスをよりコントロールするために ```cs // Custom DataTable conversion DataTable customTable = new DataTable(); // Define columns based on Excel structure for (int col = 0; col < sheet.ColumnCount; col++) { customTable.Columns.Add($"Column{col + 1}", typeof(string)); } // Import data with validation foreach (var row in sheet.Rows) { var dataRow = customTable.NewRow(); for (int col = 0; col < sheet.ColumnCount; col++) { dataRow[col] = row.Columns[col].Value ?? DBNull.Value; } customTable.Rows.Add(dataRow); } // Print column headers foreach (DataColumn column in customTable.Columns) { Console.Write($"{column.ColumnName}\t"); } Console.WriteLine(); // Print each row foreach (DataRow row in customTable.Rows) { foreach (var item in row.ItemArray) { Console.Write($"{item}\t"); } Console.WriteLine(); } ``` このアプローチは、インポート時のデータ変換に柔軟性をもたらします。 Null値は、DBNull.Valueに変換することで潔く処理し、データベース操作との互換性を確保しています。 ### 出力 [How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 8 - DataTable Output](/static-assets/excel/blog/csharp-import-excel/csharp-import-excel-8.webp). ## どのような高度な機能がデータ操作をサポートしますか? IronXLは複雑なシナリオに対応する強力な機能を備え、基本的な読み方を超えています。 ライブラリはExcelの数式を保持し、計算を動的に更新できるようにします。 [複雑なExcelワークブック](/how-to/create-spreadsheet/)を扱う開発者のために、インポート処理全体を通してデータの整合性を維持します。 [How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 9 - Features](/static-assets/excel/blog/csharp-import-excel/csharp-import-excel-9.webp). ```cs // Read calculated values from formulas WorkSheet sheet = workBook.GetWorkSheet("Reports"); decimal calculatedTotal = sheet["E10"].DecimalValue; // Reads formula result // Formulas remain intact string formula = sheet["E10"].Formula; // Returns "=SUM(E2:E9)" ``` 数式サポートとは、複雑な計算を含むExcelファイルのインポートが、ビジネスロジックを再作成することなく機能することを意味します。 このライブラリは数式を自動的に評価し、元の数式構造を保持したまま計算値を返します。 この機能は、財務モデルや報告テンプレートを含む[Excelファイル](/examples/read-excel/)を読む必要がある場合に非常に貴重です。 クロスプラットフォーム互換性により、Windows、Linux、macOS、コンテナ環境で一貫した動作が保証されます。 この柔軟性により、IronXLはOfficeのインストールが不可能なクラウド・デプロイメントやマイクロサービス・アーキテクチャに理想的です。 [.NET Foundationのドキュメント](https://docs.microsoft.com/en-us/dotnet/core/introduction)は、Excelデータをインポートする際に、最新の.NETアプリケーションがこのプラットフォームの独立性からどのような恩恵を受けているかを強調しています。 Entity Frameworkの統合により、C# Excelインポートシナリオのデータベースワークフローが効率化されます： ```cs var products = sheet.Rows.Skip(1) .Select(row => new Product { Name = row.Columns[0].StringValue, Price = row.Columns[1].DecimalValue }) .ToList(); using (var context = new AppDbContext()) { context.Products.AddRange(products); await context.SaveChangesAsync(); } ``` このパターンは、最小限のコードでExcelからデータベースへの直接パイプラインを可能にし、データ移行やETLプロセスに最適です。 包括的なExcel操作機能については、IronXLをダウンロードしてデータ・インポート・ワークフローを合理化してください。 ## 結論 IronXLはExcelデータのインポートを複雑な課題から簡単なC#コードに変換します。 このライブラリの直感的なAPI、包括的なフォーマットのサポート、クロスプラットフォームの互換性は、Excelファイルの操作を必要とするプロダクションアプリケーションにとって実用的な選択肢となっています。 [How to Easily Import, Read, and Manipulate MS Excel File Data in C# Using IronXL: Image 10 - Licensing](/static-assets/excel/blog/csharp-import-excel/csharp-import-excel-10.webp). ExcelファイルをC#プロジェクトにインポートする準備はできましたか？ [無料トライアルを開始](trial-license)してIronXLの全機能をお試しください。 詳細な実装ガイダンスについては、[完全なドキュメント](/docs/)を参照してください。 本番環境への導入については、[ライセンスオプション](/licensing/)を参照して、チームに合ったものを見つけてください。