この記事では、C# Excel ライブラリである IronXL を使用して Excel ファイルからデータを読み取り、それをデータベース テーブルに挿入する方法について説明します。

1. IronXL

IronXL は、.NET 開発者向けに設計された強力なソフトウェア ライブラリであり、.NET アプリケーションで Excel ファイルを読み取り、書き込み、操作するための使いやすい API を提供します。 Excelスプレッドシートの作成、編集、エクスポートのための包括的な機能セットを提供します。対象マシンにMicrosoft OfficeやExcelがインストールされている必要はありません。XLS、XLSX、CSV、TSVなど、幅広いファイル形式をサポートしているため、開発者はどこにでも展開できるExcelベースのアプリケーションを簡単に作成できます。 IronXL は、チャート作成、データの視覚化、データ分析などの高度な機能も提供し、小規模から大規模プロジェクトの開発プロセスを効率化します。

2. 事前準備

IronXL ライブラリを使用して Excel ファイルからデータベースに書き込む前に、特定の前提条件を満たす必要があります。 これには以下が含まれます：

• C# プロジェクトを作成するには、コンピューターに Visual Studio がインストールされている必要があります。
• C# プロジェクトを作成する前に、ASP.NET もシステムにインストールされていることを確認します。
• データをエクスポートするには、システムに IronXL ライブラリをインストールします。 Visual StudioのNuGetパッケージマネージャーからIronXL NuGetパッケージをダウンロードすることで入手できます。
• Visual Studio に SQL がインストールされている。

3. Visual Studioで新しいプロジェクトを作成する

IronXL ライブラリを利用して Excel 関連の操作を実行する前に、Visual Studio で .NET プロジェクトを作成する必要があります。 Visual Studio のどのバージョンでも互換性がありますが、利用可能な最新バージョンを使用することをお勧めします。 プロジェクトの要件に応じて、Windows フォームや ASP.NET などのさまざまなプロジェクト テンプレートから選択できます。 このチュートリアルでは、IronXL の操作方法を示すために、コンソール アプリケーション プロジェクト テンプレートを使用することをお勧めします。

新しいプロジェクトを作成する

プロジェクトタイプを選択した後、プロジェクトに名前を付け、その場所を選択する必要があります。 また、プロジェクトのために好みのフレームワーク（例：.NET Core 6）を指定することもできます。

プロジェクト構成

新しいプロジェクトが作成されると、コードを記述してアプリケーションを実行できる program.cs ファイルにアクセスできるようになります。

コードオープンのプロジェクト

Visual Studio プロジェクトが作成されたので、IronXL をインストールしましょう。

4. IronXLのインストール

IronXL ライブラリはさまざまな方法でダウンロードしてインストールできますが、この記事では最も簡単な方法を 2 つ紹介します。

• Visual Studio で NuGet パッケージを使用する。
• Visual Studioコマンドラインを使用します。

4.1 Visual Studioを使用する

IronXLライブラリをインストールする最初の方法は、Visual StudioのNuGetパッケージ マネージャーを使用することです。 NuGetパッケージマネージャを開き、参照タブでIronXLを検索してください。 検索結果にIronXLが表示されたら、それを選択してインストールを続行します。 インストールが完了したら、プロジェクトでIronXLライブラリを使用し始めることができます。

次のスクリーンショットは、Visual Studio で NuGet パッケージ マネージャーを開く方法を示しています。

NuGetパッケージマネージャー

次のスクリーンショットは、検索結果に IronXL が表示されています。

IronXL検索結果

4.2 Visual Studioコマンドラインを使用する

多くの開発者はコマンドラインインターフェースを使用してパッケージをインストールすることを好みます。 コマンドラインを使用してIronXLをインストールするには、次の手順を実行します：

• Visual Studioで、ツール > NuGetパッケージマネージャ > パッケージマネージャコンソールに移動します。

• パッケージマネージャコンソールタブで次の行を入力してください：

  Install-Package IronXL

  SHELL

パッケージはダウンロードされ、現在のプロジェクトにインストールされます。

コマンドラインによるインストール

5. SQL Server データベースのインストールと構成

SQLサーバーデータベーステーブルをC#プロジェクトと統合するには、まずNuGetパッケージマネージャーにアクセスし、System.Data.SqlClientを検索してインストールしてください。

NuGet パッケージ マネージャー UI で SqlClient を検索してインストールする

インストールしたら、プロジェクト メニューに移動して、"新しい項目の追加"をクリックします。

新しいアイテムを追加

新しいウィンドウが表示されます。 サイドメニューからデータを選択し、リストから"サービスベースのデータベース"をクリックします。データベースに適切な名前を入力し、"追加"ボタンをクリックします。

サービスベースのデータベースを選択

次に、ソリューション エクスプローラーで、新しく作成したデータベースを右クリックし、"開く"を選択します。 新しいサイドバーが開きます。

右クリックして"開く"を選択します

新しいサイドバーで、データベースをクリックしてそのプロパティに移動します。 そこから接続文字列をコピーします。

右クリックして"プロパティ"を選択します

接続文字列の処理

接続設定をコピーしたら、データベースインスタンスをクリックして新しいリストを開きます。テーブルフォルダを右クリックし、"新しいテーブルの追加"を選択します。

新しいテーブルを追加

データベースに新しいテーブルを作成するには、次の手順に従います。

1. 新しいデータ テーブル設計ページを開きます。
2. 次のSQLクエリを追加します。これは、Numberの3つの列を持つ新しいテーブルを作成します。
3. ページ上部の"更新"ボタンをクリックします。
4. 新しく生成されたテーブルがデータベースに追加されます。

CREATE TABLE [dbo].[Table]
(
  [Id] INT NOT NULL PRIMARY KEY,
  [Name] VARCHAR(100) NOT NULL,
  [Number] INT
)

CREATE TABLE [dbo].[Table]
(
  [Id] INT NOT NULL PRIMARY KEY,
  [Name] VARCHAR(100) NOT NULL,
  [Number] INT
)

SQL 環境がセットアップされたので、Excel データからこのデータベースに入力するためのサンプル データをいくつか作成してみましょう。

Excelファイルデータ

6. IronXLを使用してExcelファイルのデータをインポートし、データベースにエクスポートする

IronXL を使用すると、開発者は Excel ファイルとデータベース間でデータを転送するプロセスを自動化できるため、時間と労力を大幅に節約できます。 IronXL を利用することで、開発者はワークフローを合理化し、手動でのデータ入力の必要性をなくし、データの正確性と最新性を確保できます。

SQL サーバーをセットアップし、接続文字列をコピーしたら、以下のコードに接続文字列を貼り付け、Excel ファイルをコードにリンクし、必要に応じて SQL クエリを変更します。 次にコードを実行するだけで、データがデータベース テーブルにエクスポートされます。

using IronXL; // Import the IronXL library
using System.Data; // Import data handling library
using System.Data.SqlClient; // Import SQL Client library for SQL database operations

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("book.xlsx");

// Convert the workbook into a DataSet
DataSet dataSet = workBook.ToDataSet();

// Define the SQL query to select data from the table
string sql = "SELECT * FROM [dbo].[Table]";

// Connection string for the SQL Server
string connectionString = @"Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=C:\USERS\BUTTW\SOURCE\REPOS\CREATE PDF\CREATE PDF\DATABASE1.MDF;Integrated Security=True"; 

// Open a connection to the SQL Server using the connection string
using (SqlConnection connection = new SqlConnection(connectionString))
{
    connection.Open(); // Open connection
    // Use SqlDataAdapter to update SQL table with DataSet from Excel file
    SqlDataAdapter adapter = new SqlDataAdapter(sql, connection);
    adapter.Update(dataSet);
}

using IronXL; // Import the IronXL library
using System.Data; // Import data handling library
using System.Data.SqlClient; // Import SQL Client library for SQL database operations

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("book.xlsx");

// Convert the workbook into a DataSet
DataSet dataSet = workBook.ToDataSet();

// Define the SQL query to select data from the table
string sql = "SELECT * FROM [dbo].[Table]";

// Connection string for the SQL Server
string connectionString = @"Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=C:\USERS\BUTTW\SOURCE\REPOS\CREATE PDF\CREATE PDF\DATABASE1.MDF;Integrated Security=True"; 

// Open a connection to the SQL Server using the connection string
using (SqlConnection connection = new SqlConnection(connectionString))
{
    connection.Open(); // Open connection
    // Use SqlDataAdapter to update SQL table with DataSet from Excel file
    SqlDataAdapter adapter = new SqlDataAdapter(sql, connection);
    adapter.Update(dataSet);
}

Imports IronXL ' Import the IronXL library
Imports System.Data ' Import data handling library
Imports System.Data.SqlClient ' Import SQL Client library for SQL database operations

' Load the Excel workbook
Private workBook As WorkBook = WorkBook.Load("book.xlsx")

' Convert the workbook into a DataSet
Private dataSet As DataSet = workBook.ToDataSet()

' Define the SQL query to select data from the table
Private sql As String = "SELECT * FROM [dbo].[Table]"

' Connection string for the SQL Server
Private connectionString As String = "Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=C:\USERS\BUTTW\SOURCE\REPOS\CREATE PDF\CREATE PDF\DATABASE1.MDF;Integrated Security=True"

' Open a connection to the SQL Server using the connection string
Using connection As New SqlConnection(connectionString)
	connection.Open() ' Open connection
	' Use SqlDataAdapter to update SQL table with DataSet from Excel file
	Dim adapter As New SqlDataAdapter(sql, connection)
	adapter.Update(dataSet)
End Using

Imports IronXL ' Import the IronXL library
Imports System.Data ' Import data handling library
Imports System.Data.SqlClient ' Import SQL Client library for SQL database operations

' Load the Excel workbook
Private workBook As WorkBook = WorkBook.Load("book.xlsx")

' Convert the workbook into a DataSet
Private dataSet As DataSet = workBook.ToDataSet()

' Define the SQL query to select data from the table
Private sql As String = "SELECT * FROM [dbo].[Table]"

' Connection string for the SQL Server
Private connectionString As String = "Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=C:\USERS\BUTTW\SOURCE\REPOS\CREATE PDF\CREATE PDF\DATABASE1.MDF;Integrated Security=True"

' Open a connection to the SQL Server using the connection string
Using connection As New SqlConnection(connectionString)
	connection.Open() ' Open connection
	' Use SqlDataAdapter to update SQL table with DataSet from Excel file
	Dim adapter As New SqlDataAdapter(sql, connection)
	adapter.Update(dataSet)
End Using

データがデータベースに正常にエクスポートされたかどうかを確認するには、テーブルディレクトリをもう一度右クリックし、"新しいクエリ"をクリックします。新しいページが開くので、上部のバーからデータベースを選択し、適切な SQL クエリを実行してデータを取得します。

SELECT * FROM [dbo].[Table]

SELECT * FROM [dbo].[Table]

緑のボタンを押すと、1秒以内に結果が表示されます。

データベースデータ

これは、Microsoft Excel ファイルからインポートしたデータをデータベースに書き込む方法です。

7. 結論

Excel スプレッドシートの操作は多くのアプリケーションで一般的なタスクであり、Excel シートからデータベース テーブルにデータを挿入すると、データ管理プロセスを効率化できます。 C# でこのタスクを実現する 1 つの方法は、IronXL などの Excel ファイルの読み取りと操作を可能にするライブラリを使用することです。 このライブラリを利用することで、開発者は Excel シートからデータを簡単に抽出し、データベース テーブルに挿入できるため、データ管理プロセスが簡素化され、エラーの可能性が低減します。 この記事では、IronXL ライブラリを使用して、Excel ファイルから SQL Server データベース内の SQL Server テーブルにデータを追加する手順について説明します。 また、IronXL ライブラリの簡単な紹介、データの挿入に必要な前提条件について説明し、Visual Studio で新しいプロジェクトを作成する方法、 IronXLをインストールする方法、および SQL Server データベースを構成する方法についても説明します。 C# でExcel ファイルを読み取る方法については、次のチュートリアルをご覧ください。

さらに、IronXL は、テキストの配置、フォント サイズ、色、パネルの固定、数式の追加、条件付き書式の適用、パスワードによる暗号化などのセル書式設定のサポートを含む高度な機能も提供します。

ユーザーは、IronPDF, IronOCR, IronXL, IronBarcode, IronWebScraperを含むソフトウェア開発ツールのコレクション、Iron Suiteからも恩恵を受けられます。