C#でExcelファイルをインポートする方法
IronXLは、C#開発者がたった1行のコードでExcelデータをインポートすることを可能にし、Interopに依存することなくXLSX、CSV、その他のフォーマットをサポートし、データ操作のためにセル、範囲、ワークシートに即座にアクセスできるようにします。
クイックスタート:Excelファイルを瞬時にロードIronXLのタイムアウトのないAPIを使用すると、1回のメソッド呼び出しで、対応するExcelシート(XLSX、CSVなど)を数秒で読み込めます。Interopは不要で、手間もかかりません。読み込んだワークブックのセル、範囲、シートにアクセスして、すぐに操作を開始できます。
-
1IronXL を NuGet Package Manager でインストールします
-
2このコード スニペットをコピーして実行します。
WorkBook wb = IronXL.WorkBook.Load("path/to/data.xlsx");Dim wb As WorkBook = WorkBook.Load("path/to/data.xlsx")Dim wb As WorkBook = WorkBook.Load("path/to/data.xlsx") -
3実際の環境でテストするためにデプロイする
今日からご自身のプロジェクトでIronXLを使い始めるには、無料トライアルをお試しください。
C#でExcelデータをインポート
- IronXLライブラリを使用してデータをインポートする
- C#でExcelデータをインポートする
- 特定のセル範囲のデータをインポートする
- SUM、AVG、MIN、MAXなどの集計関数を使用してExcelデータをインポートします
最小限のワークフロー(5ステップ)
- ExcelファイルをインポートするためのC#ライブラリをダウンロードしてインストール
- インポートするExcelファイルを準備する
Loadメソッドを使用してスプレッドシートをインポートする- 直感的なAPIを使用して読み込んだExcelファイルを編集する
- 編集したExcelファイルをさまざまな形式でエクスポートする
ステップ1
IronXLライブラリのインストール
IronXLでExcelインポートをより簡単に
このチュートリアルで使用するIronXL Excelライブラリの機能を使ってデータをインポートします。 ソフトウェアは開発のために無料で利用可能です。 IronXLは、Microsoft OfficeやInteropの依存を必要とせずに、Excelファイルを簡単に操作できる包括的なC# Excel APIを提供します。 そのため、サーバー環境やクラウドのデプロイメントに最適です。
インストール方法
DLLダウンロード経由でC#プロジェクトにインストールするか、NuGetパッケージからインストールします。 詳細なインストールガイダンスについては、はじめにガイドをご覧ください。
チュートリアル
プロジェクトでのワークシートアクセス
基本的なワークブック読み込みプロセス
このプロジェクトでは、ステップ1でインストールしたIronXLを使用してC#アプリケーションにExcelデータをインポートします。このライブラリは様々なExcel形式をサポートしており、スプレッドシートを読み込むための直感的なメソッドを提供します。
ステップ2では、IronXLのWorkBook.Load()関数を使用して、Excel WorkBookをC#プロジェクトに読み込みます。 この関数では、Excel WorkBookのパスを文字列パラメータとして渡します。
// Load Excel file
WorkBook wb = WorkBook.Load("Path");// Load Excel file
WorkBook wb = WorkBook.Load("Path");' Load Excel file
Dim wb As WorkBook = WorkBook.Load("Path")' Load Excel file
Dim wb As WorkBook = WorkBook.Load("Path")指定されたパスのExcelファイルがwbに読み込まれます。 この方法では、XLSX、XLS、CSV、TSV、その他の一般的なスプレッドシート形式をサポートしています。
特定のワークシートへのアクセス
次に、特定のExcel WorkSheet のデータをプロジェクトにインポートする必要があります。 この目的のために、IronXLのGetWorkSheet()関数を使用して、インポートするWorkBookのシートを指定するために、シート名を文字列パラメータとして渡します。 ワークシートの管理について詳しくは、当社のガイドをご覧ください。
// Specify sheet name of Excel WorkBook
WorkSheet ws = wb.GetWorkSheet("SheetName");// Specify sheet name of Excel WorkBook
WorkSheet ws = wb.GetWorkSheet("SheetName");' Specify sheet name of Excel WorkBook
Dim ws As WorkSheet = wb.GetWorkSheet("SheetName")' Specify sheet name of Excel WorkBook
Dim ws As WorkSheet = wb.GetWorkSheet("SheetName")WorkSheetはwsとしてインポートされ、wbは上記のコードサンプルで定義したWorkBookです。
ワークシートにアクセスするための代替方法
次の代替方法で、Excel WorkSheetをプロジェクトにインポートできます。 それぞれの方法は、特定のユースケースに応じて柔軟性を提供します:
// Import WorkSheet by various methods
// by sheet indexing
WorkSheet mySheet = wb.WorkSheets[SheetIndex];
// get default WorkSheet
WorkSheet defaultSheet = wb.DefaultWorkSheet;
// get first WorkSheet
WorkSheet firstSheet = wb.WorkSheets.First();
// for the first or default sheet
WorkSheet firstOrDefaultSheet = wb.WorkSheets.FirstOrDefault();// Import WorkSheet by various methods
// by sheet indexing
WorkSheet mySheet = wb.WorkSheets[SheetIndex];
// get default WorkSheet
WorkSheet defaultSheet = wb.DefaultWorkSheet;
// get first WorkSheet
WorkSheet firstSheet = wb.WorkSheets.First();
// for the first or default sheet
WorkSheet firstOrDefaultSheet = wb.WorkSheets.FirstOrDefault();' Import WorkSheet by various methods
' by sheet indexing
Dim mySheet As WorkSheet = wb.WorkSheets(SheetIndex)
' get default WorkSheet
Dim defaultSheet As WorkSheet = wb.DefaultWorkSheet
' get first WorkSheet
Dim firstSheet As WorkSheet = wb.WorkSheets.First()
' for the first or default sheet
Dim firstOrDefaultSheet As WorkSheet = wb.WorkSheets.FirstOrDefault()' Import WorkSheet by various methods
' by sheet indexing
Dim mySheet As WorkSheet = wb.WorkSheets(SheetIndex)
' get default WorkSheet
Dim defaultSheet As WorkSheet = wb.DefaultWorkSheet
' get first WorkSheet
Dim firstSheet As WorkSheet = wb.WorkSheets.First()
' for the first or default sheet
Dim firstOrDefaultSheet As WorkSheet = wb.WorkSheets.FirstOrDefault()さて、指定されたExcelファイルから任意のタイプのデータを簡単にインポートできます。 ここからは、Excelファイルのデータをプロジェクトにインポートするさまざまな方法を説明します。
C#におけるExcelデータのインポート
セルの基本的なインポート方法
これはプロジェクトにExcelファイルデータをインポートする基本的な側面です。 IronXLはセルデータにアクセスする複数の方法を提供し、さまざまなシナリオに柔軟に対応します。
この目的のために、どのセルデータをインポートする必要があるかを指定するセルアドレッシングシステムを使用できます。 Excelファイルから特定のセルアドレスの値を返します:
var cellValue = ws["Cell Address"];var cellValue = ws["Cell Address"];Dim cellValue = ws("Cell Address")Dim cellValue = ws("Cell Address")行と列インデックスを使用したデータのインポート
Excelファイルからセルデータを行と列のインデックスを使用してインポートすることもできます。 このコード行は、指定された行と列のインデックスの値を返します。 このアプローチは、プログラムでデータを反復処理する場合に特に役立ちます:
var cellValueByIndex = ws.Rows[RowIndex].Columns[ColumnIndex];var cellValueByIndex = ws.Rows[RowIndex].Columns[ColumnIndex];Dim cellValueByIndex = ws.Rows(RowIndex).Columns(ColumnIndex)Dim cellValueByIndex = ws.Rows(RowIndex).Columns(ColumnIndex)インポートした値を変数に格納
インポートしたセルの値を変数に代入するには、次のコードを使用してください。 ToString()メソッドは文字列変数との互換性を保証しますが、必要に応じて他の型にキャストすることもできます。
// Import Data by Cell Address
// by cell addressing
string val = ws["Cell Address"].ToString();
// by row and column indexing
string valWithIndexing = ws.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();
// for numeric values
decimal numericValue = ws["B2"].DecimalValue;
// for date values
DateTime dateValue = ws["C2"].DateTimeValue;// Import Data by Cell Address
// by cell addressing
string val = ws["Cell Address"].ToString();
// by row and column indexing
string valWithIndexing = ws.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();
// for numeric values
decimal numericValue = ws["B2"].DecimalValue;
// for date values
DateTime dateValue = ws["C2"].DateTimeValue;' Import Data by Cell Address
' by cell addressing
Dim val As String = ws("Cell Address").ToString()
' by row and column indexing
Dim valWithIndexing As String = ws.Rows(RowIndex).Columns(ColumnIndex).Value.ToString()
' for numeric values
Dim numericValue As Decimal = ws("B2").DecimalValue
' for date values
Dim dateValue As DateTime = ws("C2").DateTimeValue' Import Data by Cell Address
' by cell addressing
Dim val As String = ws("Cell Address").ToString()
' by row and column indexing
Dim valWithIndexing As String = ws.Rows(RowIndex).Columns(ColumnIndex).Value.ToString()
' for numeric values
Dim numericValue As Decimal = ws("B2").DecimalValue
' for date values
Dim dateValue As DateTime = ws("C2").DateTimeValue上記の例では、行と列のインデックスは0から始まります。より高度なセル操作については、セルのクリアとセルのコピーに関するガイドをご覧ください。
特定範囲からのデータインポート
範囲関数の構文
Excel WorkBookの特定の範囲のデータをインポートするには、range関数を使用します。 開始セルと終了セルのアドレスを記述して、範囲を定義します。 これは、指定された範囲内のすべてのセルの値を返します。 包括的な範囲選択テクニックについては、範囲選択ガイドをご覧ください。
var rangeData = ws["Starting Cell Address:Ending Cell Address"];var rangeData = ws["Starting Cell Address:Ending Cell Address"];Dim rangeData = ws("Starting Cell Address:Ending Cell Address")Dim rangeData = ws("Starting Cell Address:Ending Cell Address")完全な範囲インポートの例
Excelファイルでの範囲操作や、さまざまな方法でのデータ取得についての詳細は、こちらをご覧ください。 次の例では、個々のセル値と範囲の両方をインポートしています:
using IronXL;
using System;
// Import Excel WorkBook
WorkBook wb = WorkBook.Load("sample.xlsx");
// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Import data of specific cell
string val = ws["A4"].Value.ToString();
Console.WriteLine("Import Value of A4 Cell address: {0}", val);
Console.WriteLine("import Values in Range From B3 To B9 :\n");
// Import data in specific range
foreach (var item in ws["B3:B9"])
{
Console.WriteLine(item.Value.ToString());
}
Console.ReadKey();using IronXL;
using System;
// Import Excel WorkBook
WorkBook wb = WorkBook.Load("sample.xlsx");
// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Import data of specific cell
string val = ws["A4"].Value.ToString();
Console.WriteLine("Import Value of A4 Cell address: {0}", val);
Console.WriteLine("import Values in Range From B3 To B9 :\n");
// Import data in specific range
foreach (var item in ws["B3:B9"])
{
Console.WriteLine(item.Value.ToString());
}
Console.ReadKey();Imports IronXL
Imports System
' Import Excel WorkBook
Dim wb As WorkBook = WorkBook.Load("sample.xlsx")
' Specify WorkSheet
Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
' Import data of specific cell
Dim val As String = ws("A4").Value.ToString()
Console.WriteLine("Import Value of A4 Cell address: {0}", val)
Console.WriteLine("import Values in Range From B3 To B9 :" & vbCrLf)
' Import data in specific range
For Each item In ws("B3:B9")
Console.WriteLine(item.Value.ToString())
Next
Console.ReadKey()Imports IronXL
Imports System
' Import Excel WorkBook
Dim wb As WorkBook = WorkBook.Load("sample.xlsx")
' Specify WorkSheet
Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
' Import data of specific cell
Dim val As String = ws("A4").Value.ToString()
Console.WriteLine("Import Value of A4 Cell address: {0}", val)
Console.WriteLine("import Values in Range From B3 To B9 :" & vbCrLf)
' Import data in specific range
For Each item In ws("B3:B9")
Console.WriteLine(item.Value.ToString())
Next
Console.ReadKey()上記のコードは次の出力を表示します:
Excelファイルsample.xlsxの値は以下のとおりです:
集計関数を使ったExcelデータのインポート
利用可能な集計関数
Excelファイルに集計関数を適用し、その結果得られたデータをインポートします。 IronXLはデータ解析を簡単にする組み込みの数学関数を提供します。 以下は、さまざまな関数とその使用例です:
-
Sum()// To find the sum of a specific cell range var sum = ws["Starting Cell Address:Ending Cell Address"].Sum();// To find the sum of a specific cell range var sum = ws["Starting Cell Address:Ending Cell Address"].Sum();' To find the sum of a specific cell range Dim sum = ws("Starting Cell Address:Ending Cell Address").Sum()' To find the sum of a specific cell range Dim sum = ws("Starting Cell Address:Ending Cell Address").Sum() -
Average()// To find the average of a specific cell range var average = ws["Starting Cell Address:Ending Cell Address"].Avg();// To find the average of a specific cell range var average = ws["Starting Cell Address:Ending Cell Address"].Avg();' To find the average of a specific cell range Dim average = ws("Starting Cell Address:Ending Cell Address").Avg()' To find the average of a specific cell range Dim average = ws("Starting Cell Address:Ending Cell Address").Avg() -
Min()// To find the minimum in a specific cell range var minimum = ws["Starting Cell Address:Ending Cell Address"].Min();// To find the minimum in a specific cell range var minimum = ws["Starting Cell Address:Ending Cell Address"].Min();' To find the minimum in a specific cell range Dim minimum = ws("Starting Cell Address:Ending Cell Address").Min()' To find the minimum in a specific cell range Dim minimum = ws("Starting Cell Address:Ending Cell Address").Min() -
Max()// To find the maximum in a specific cell range var maximum = ws["Starting Cell Address:Ending Cell Address"].Max();// To find the maximum in a specific cell range var maximum = ws["Starting Cell Address:Ending Cell Address"].Max();' To find the maximum in a specific cell range Dim maximum = ws("Starting Cell Address:Ending Cell Address").Max()' To find the maximum in a specific cell range Dim maximum = ws("Starting Cell Address:Ending Cell Address").Max()
複数の集計関数を同時に使用
C#のExcelで集計関数を使用し、さまざまな方法でデータを取得する方法については、こちらをご覧ください。 これらの関数は、要約統計の生成やインポートされたデータの検証に特に役立ちます。
これらの関数を適用してExcelファイルのデータをインポートする例を参照してください:
using IronXL;
using System;
// Import Excel file
WorkBook wb = WorkBook.Load("sample.xlsx");
// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Import Excel file data by applying aggregate functions
decimal sum = ws["D2:D9"].Sum();
decimal avg = ws["D2:D9"].Avg();
decimal min = ws["D2:D9"].Min();
decimal max = ws["D2:D9"].Max();
Console.WriteLine("Sum From D2 To D9: {0}", sum);
Console.WriteLine("Avg From D2 To D9: {0}", avg);
Console.WriteLine("Min From D2 To D9: {0}", min);
Console.WriteLine("Max From D2 To D9: {0}", max);
Console.ReadKey();using IronXL;
using System;
// Import Excel file
WorkBook wb = WorkBook.Load("sample.xlsx");
// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Import Excel file data by applying aggregate functions
decimal sum = ws["D2:D9"].Sum();
decimal avg = ws["D2:D9"].Avg();
decimal min = ws["D2:D9"].Min();
decimal max = ws["D2:D9"].Max();
Console.WriteLine("Sum From D2 To D9: {0}", sum);
Console.WriteLine("Avg From D2 To D9: {0}", avg);
Console.WriteLine("Min From D2 To D9: {0}", min);
Console.WriteLine("Max From D2 To D9: {0}", max);
Console.ReadKey();Imports IronXL
Imports System
' Import Excel file
Dim wb As WorkBook = WorkBook.Load("sample.xlsx")
' Specify WorkSheet
Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
' Import Excel file data by applying aggregate functions
Dim sum As Decimal = ws("D2:D9").Sum()
Dim avg As Decimal = ws("D2:D9").Avg()
Dim min As Decimal = ws("D2:D9").Min()
Dim max As Decimal = ws("D2:D9").Max()
Console.WriteLine("Sum From D2 To D9: {0}", sum)
Console.WriteLine("Avg From D2 To D9: {0}", avg)
Console.WriteLine("Min From D2 To D9: {0}", min)
Console.WriteLine("Max From D2 To D9: {0}", max)
Console.ReadKey()Imports IronXL
Imports System
' Import Excel file
Dim wb As WorkBook = WorkBook.Load("sample.xlsx")
' Specify WorkSheet
Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
' Import Excel file data by applying aggregate functions
Dim sum As Decimal = ws("D2:D9").Sum()
Dim avg As Decimal = ws("D2:D9").Avg()
Dim min As Decimal = ws("D2:D9").Min()
Dim max As Decimal = ws("D2:D9").Max()
Console.WriteLine("Sum From D2 To D9: {0}", sum)
Console.WriteLine("Avg From D2 To D9: {0}", avg)
Console.WriteLine("Min From D2 To D9: {0}", min)
Console.WriteLine("Max From D2 To D9: {0}", max)
Console.ReadKey()上記のコードは次の出力を与えます:
そして私たちのファイルsample.xlsxにはこれらの値が含まれています:
完全なExcelファイルデータのインポート
ToDataSetメソッド
C#プロジェクトに完全なExcelファイルデータをインポートするには、まずロードされたWorkBookをDataSetに変換します。 この方法で、完全なExcelデータがDataSetにインポートされ、Excelファイル内のWorkSheetsがそのDataSet内でDataTablesになります。 このアプローチは、データベース操作やデータバインドコントロールを使用する場合に特に役立ちます。 詳細については、DataSetとしてのインポートとエクスポートに関する説明をご覧ください。
// Import WorkBook into DataSet
DataSet ds = wb.ToDataSet();// Import WorkBook into DataSet
DataSet ds = wb.ToDataSet();' Import WorkBook into DataSet
Dim ds As DataSet = wb.ToDataSet()' Import WorkBook into DataSet
Dim ds As DataSet = wb.ToDataSet()これにより、指定したWorkSheetがDataSetにインポートされ、要件に応じて利用できます。 この方法は、複数のシートを同時に扱う場合や、ExcelのデータをADO.NETの操作と統合する場合に特に威力を発揮します。
カラムヘッダの処理
多くの場合、Excelファイルの最初の行が列名として機能します。 この場合、最初の行をDataTable列名にします。 IronXLのToDataSet()関数のブールパラメータを次のように設定します。
// Import WorkBook into DataSet with first row as ColumnNames
DataSet ds = wb.ToDataSet(true);// Import WorkBook into DataSet with first row as ColumnNames
DataSet ds = wb.ToDataSet(true);netnetこれにより、Excelファイルの最初の行がDataTable列名となり、構造化Excelデータを扱う際にデータ構造の整合性を保つために重要です。
完全なデータセットインポートの例
ExcelデータをDataSetにインポートし、Excel WorkSheetの最初の行をDataTable列名として使用する完全な例を参照してください。
using IronXL;
using System;
using System.Data;
WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Import Excel data into a DataSet
DataSet ds = wb.ToDataSet(true);
Console.WriteLine("Excel file data imported to dataset successfully.");
Console.ReadKey();using IronXL;
using System;
using System.Data;
WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Import Excel data into a DataSet
DataSet ds = wb.ToDataSet(true);
Console.WriteLine("Excel file data imported to dataset successfully.");
Console.ReadKey();Imports IronXL
Imports System
Imports System.Data
Dim wb As WorkBook = WorkBook.Load("sample.xlsx")
Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
' Import Excel data into a DataSet
Dim ds As DataSet = wb.ToDataSet(True)
Console.WriteLine("Excel file data imported to dataset successfully.")
Console.ReadKey()Imports IronXL
Imports System
Imports System.Data
Dim wb As WorkBook = WorkBook.Load("sample.xlsx")
Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
' Import Excel data into a DataSet
Dim ds As DataSet = wb.ToDataSet(True)
Console.WriteLine("Excel file data imported to dataset successfully.")
Console.ReadKey()Excel DatasetおよびDataTable関数で作業するのは複雑かもしれませんが、C#プロジェクトにファイルデータを組み込むための例はもっとあります。 高度なシナリオのために、DataTableを介してExcelをSQLに変換し、SQLデータベースからExcelを読み込むためのガイドを調べてください。
ToDataSetはすべての行を同時にメモリに保持しますが、これはほとんどのインポートが扱うファイルサイズに適しています。 ソースファイルが十分に大きく、DataSet自体がボトルネックになる場合、行をストリームし、バッチ単位で宛先にフラッシュして、最大メモリ使用量が行数ではなくバッチサイズを基にするようにします。
ライブラリのクイックアクセス
よくある質問
IronXLを使用してExcelファイルをC#プロジェクトにインポートする方法は?
IronXLを使用してWorkBook.Load()メソッドでExcelファイルをC#プロジェクトにインポートできます。このメソッドを使えば、Interop依存なしでXLSXやCSV、その他の形式をロードできます。
C#でIronXLを使用してどの形式をインポートできますか?
IronXLは、Interopを必要とせずに、XLSX、CSV、TSVなど、さまざまなスプレッドシート形式をC#プロジェクトにインポートすることをサポートしています。
C#でIronXLを使用してExcelファイルから特定のワークシートにアクセスすることは可能ですか?
はい、IronXLで特定のワークシートにアクセスする際には、ワークシート名を文字列パラメータとして渡すGetWorkSheet()メソッドを使用できます。
IronXLはC#でインポートされたExcelデータに対して集計関数を実行できますか?
はい、IronXLを使用すると、C#プロジェクトでインポートされたExcelファイルのデータに対してSum()、Avg()、Min()、Max()といった集計関数を実行できます。
IronXLでExcelセルの特定の範囲からデータをインポートするにはどうすればよいですか?
IronXLで特定の範囲からデータをインポートするには、範囲関数の構文を使ってws["開始セルアドレス:終了セルアドレス"]のように記述し、指定したExcelセル範囲から値を取得します。
IronXLでExcelデータをC#でDataSetとして使用することは可能ですか?
はい、IronXLのToDataSet()メソッドを使用して、Excelファイル全体のデータをDataSetにインポートできます。このメソッドは、特にデータベース操作やデータバウンドコントロールに便利です。
Excelファイルの最初の行をIronXLで列名として使用できますか?
はい、ExcelデータをDataSetにインポートする際に、IronXLのToDataSet(true)メソッドを使用して最初の行を列名として設定することができます。
IronXLでExcelセルから数値や日付の値をインポートする方法は?
IronXLでは、特定のExcelセルから数値の値を.DecimalValue、日付の値を.DateTimeValueを使用してインポートし、正しいデータ型を確保できます。
C#でのExcelインポートでInteropよりIronXLを使用する利点は何ですか?
IronXLはInterop依存がなく、サーバー環境やクラウド環境でのMicrosoft Officeインストールが不要な場合に理想的です。
IronXLは開発目的で無料で利用可能ですか?
はい、IronXLは開発目的で無料で利用可能で、C#でのExcelファイル操作を簡素化する包括的なExcel APIを提供します。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。



