C#でのExcelファイル作成チュートリアル
このチュートリアルでは、.NET Framework 4.5 または .NET Core をサポートする任意のプラットフォームで Excel ワークブック ファイルを作成する方法をステップバイステップで案内します。 C#でExcelファイルを作成することは、レガシーなMicrosoft.Office.Interop.Excelライブラリに依存せずに簡単に行えます。 IronXLを使用して、ウィークシートのプロパティ（例えば、ウィンドウ枠の固定や保護）、印刷プロパティの設定などを行います。
概要
C#でExcelファイルを作成する方法
- ExcelとCSVファイルを作成するためのC#ライブラリをダウンロード
- ASP.NETプロジェクトWebアプリケーションを作成する
- C#ライブラリを使用してExcelワークブックを作成する
- Excelワークシートでセルの値を手動で設定
- 書式を適用し、セルの背景色を設定する
- セルに数式を使用
- ワークシートと印刷のプロパティを設定する
- Excelワークブックを保存
IronXL Creates C# Excel Files in .NET
IronXLは直感的なC# & VB Excel APIで、.NETでExcelスプレッドシートファイルを読み込み、編集、作成することができ、非常に高速なパフォーマンスを提供します。 MS OfficeやExcel Interopをインストールする必要はありません。
IronXLは、.NET Core、.NET Framework、Xamarin、モバイル、Linux、macOS、およびAzureを完全にサポートしています。
IronXLの機能:
- Human support directly from our .NET development team
- Rapid installation with Microsoft Visual Studio
- FREE for development. Licenses from $749.
エクセルファイルの作成と保存：クイックコード
https://www.nuget.org/packages/IronXL.Excel/ 代替として、IronXL.dllをダウンロードしてプロジェクトに追加できます。
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-1.csusing IronXL;
// Default file format is XLSX, we can override it using CreatingOptions
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
var workSheet = workBook.CreateWorkSheet("example_sheet");
workSheet["A1"].Value = "Example";
// Set value to multiple cells
workSheet["A2:A4"].Value = 5;
workSheet["A5"].Style.SetBackgroundColor("#f0f0f0");
// Set style to multiple cells
workSheet["A5:A6"].Style.Font.Bold = true;
// Set formula
workSheet["A6"].Value = "=SUM(A2:A4)";
if (workSheet["A6"].IntValue == workSheet["A2:A4"].IntValue)
{
Console.WriteLine("Basic test passed");
}
workBook.SaveAs("example_workbook.xlsx");Imports IronXL
' Default file format is XLSX, we can override it using CreatingOptions
Private workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Private workSheet = workBook.CreateWorkSheet("example_sheet")
Private workSheet("A1").Value = "Example"
' Set value to multiple cells
Private workSheet("A2:A4").Value = 5
workSheet("A5").Style.SetBackgroundColor("#f0f0f0")
' Set style to multiple cells
workSheet("A5:A6").Style.Font.Bold = True
' Set formula
workSheet("A6").Value = "=SUM(A2:A4)"
If workSheet("A6").IntValue = workSheet("A2:A4").IntValue Then
Console.WriteLine("Basic test passed")
End If
workBook.SaveAs("example_workbook.xlsx")ステップ 1
以下を日本語に翻訳してください：
- 無料のIronXL C#ライブラリをダウンロード
今日から無料トライアルでIronXLをあなたのプロジェクトで使い始めましょう。
NuGet を使用してインストール
IronXL NuGetパッケージをインストールするには、3つの異なる方法があります:
-
Visual Studio (ビジュアルスタジオ)
-
開発者コマンドプロンプト
-
NuGetパッケージを直接ダウンロード
ビジュアルスタジオ
Visual Studio は、あなたのプロジェクトに NuGet パッケージをインストールするために使用する NuGet パッケージ マネージャーを提供します。 プロジェクトメニューからアクセスするか、ソリューションエクスプローラーでプロジェクトを右クリックしてください。 以下の図3と図4に両方のオプションが示されています。
図3 – プロジェクトメニュー 
図4 – ソリューションエクスプローラーを右クリック
いずれかのオプションから「NuGet パッケージの管理」をクリックした後、「IronXL.Excel」パッケージを参照してインストールします（図5 に示すように）。
Figure 5 – Install IronXL.Excel NuGet Package
開発者コマンドプロンプト
開発者コマンドプロンプトを開き、以下の手順に従ってIronXL.Excel NuGetパッケージをインストールしてください:
-
開発者コマンドプロンプトを探します - 通常、Visual Studio フォルダの下にあります。
-
以下のコマンドを入力してください:
-
PM > Install-Package IronXL.Excel
-
Enterキーを押してください
-
パッケージがインストールされます。
-
Visual Studioプロジェクトをリロードしてください
NuGetパッケージを直接ダウンロード
NuGetパッケージをダウンロードするには、以下の手順に従ってください:
-
以下のURLに移動してください: https://www.nuget.org/packages/ironxl.excel/
-
パッケージをダウンロードするをクリックしてください
-
パッケージがダウンロードされた後、ダブルクリックしてください。
-
Visual Studioプロジェクトをリロードしてください
IronXLをライブラリの直接ダウンロードでインストールする
IronXLをインストールする2番目の方法は、以下のURLから直接ダウンロードすることです: https://ironsoftware.com/csharp/excel/
Figure 6 – Download IronXL library
次の手順を使用して、プロジェクト内でライブラリを参照してください：
-
ソリューションエクスプローラーでソリューションを右クリックします
-
参照を選択
-
IronXL.dllライブラリを参照してください
- 「OK」をクリック
さあ、行こう！
セットアップが完了したので、IronXLライブラリの素晴らしい機能を操作し始めましょう！
チュートリアルの方法
2. ASP.NET プロジェクトを作成
- 以下のURLに移動します:
- https://www.nuget.org/packages/ironxl.excel/
- パッケージをダウンロードするをクリックしてください
- パッケージがダウンロードされた後、ダブルクリックしてください。
- Visual Studioプロジェクトをリロードしてください
ASP.NETウェブサイトを作成するには、次の手順を使用します。
-
Visual Studio を開く
-
ファイル > 新しいプロジェクトをクリック
-
プロジェクトタイプのリストボックス에서 Visual C#の下にあるWebを選択します
-
「次に示すように、ASP.NET Webアプリケーションを選択してください。」
図1– 新しいプロジェクト
-
「OK」をクリック
-
次の画面で、図2に示すように「Web Forms」を選択してください。
図2 – Webフォーム
-
「OK」をクリック
これで作業に取り掛かることができます。 IronXLをインストールして、ファイルのカスタマイズを開始しましょう。
3. Excel ワークブックを作成する
IronXLを使って新しいExcelブックを作成するのはとても簡単です！ それは1行のコードです！ はい、本当に:
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-2.csWorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)IronXLを使用して、XLS（旧Excelファイルバージョン）とXLSX（現在および新しいファイルバージョン）の両方のファイル形式を作成することができます。
3.1. デフォルトのワークシートを設定 ###
さらに、デフォルトのWorksheetを作成するのはもっと簡単です：
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-3.csWorkSheet workSheet = workBook.CreateWorkSheet("2020 Budget");Dim workSheet As WorkSheet = workBook.CreateWorkSheet("2020 Budget")上記のコードスニペットにおける「Sheet」はワークシートを表しており、セルの値を設定したり、Excelが行えるほぼすべての操作を行うことができます。
ワークブックとワークシートの違いについて混乱している場合は、説明させていただきます:
ワークブックにはワークシートが含まれています。 これは、一つのワークブックに好きなだけワークシートを追加できることを意味します。 後の記事でその方法を説明します。 ワークシートには行と列が含まれます。 行と列の交差点はセルと呼ばれ、これがExcelで作業する際に操作するものです。
4. セル値の設定 ##
4.1. セル値を手動で設定する ###
セルの値を手動で設定するには、操作しているセルを指定し、以下の例のようにその値を設定します：
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-4.csworkSheet["A1"].Value = "January";
workSheet["B1"].Value = "February";
workSheet["C1"].Value = "March";
workSheet["D1"].Value = "April";
workSheet["E1"].Value = "May";
workSheet["F1"].Value = "June";
workSheet["G1"].Value = "July";
workSheet["H1"].Value = "August";
workSheet["I1"].Value = "September";
workSheet["J1"].Value = "October";
workSheet["K1"].Value = "November";
workSheet["L1"].Value = "December";workSheet("A1").Value = "January"
workSheet("B1").Value = "February"
workSheet("C1").Value = "March"
workSheet("D1").Value = "April"
workSheet("E1").Value = "May"
workSheet("F1").Value = "June"
workSheet("G1").Value = "July"
workSheet("H1").Value = "August"
workSheet("I1").Value = "September"
workSheet("J1").Value = "October"
workSheet("K1").Value = "November"
workSheet("L1").Value = "December"ここで、列AからLにデータを入力し、各列の最初の行を異なる月の名前にしました。
4.2. セルの値を動的に設定する ###
値を動的に設定することは、前のコードセグメントとほとんど同じです。 これの良い点は、セルの位置をハードコーディングする必要がないことです。 次のコード例では、ランダムな数値を生成するために新しいRandomオブジェクトを作成し、その後、値を入力したいセルの範囲を反復処理するためのforループを使用します。
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-5.csRandom r = new Random();
for (int i = 2 ; i <= 11 ; i++)
{
workSheet["A" + i].Value = r.Next(1, 1000);
workSheet["B" + i].Value = r.Next(1000, 2000);
workSheet["C" + i].Value = r.Next(2000, 3000);
workSheet["D" + i].Value = r.Next(3000, 4000);
workSheet["E" + i].Value = r.Next(4000, 5000);
workSheet["F" + i].Value = r.Next(5000, 6000);
workSheet["G" + i].Value = r.Next(6000, 7000);
workSheet["H" + i].Value = r.Next(7000, 8000);
workSheet["I" + i].Value = r.Next(8000, 9000);
workSheet["J" + i].Value = r.Next(9000, 10000);
workSheet["K" + i].Value = r.Next(10000, 11000);
workSheet["L" + i].Value = r.Next(11000, 12000);
}Dim r As New Random()
For i As Integer = 2 To 11
workSheet("A" & i).Value = r.Next(1, 1000)
workSheet("B" & i).Value = r.Next(1000, 2000)
workSheet("C" & i).Value = r.Next(2000, 3000)
workSheet("D" & i).Value = r.Next(3000, 4000)
workSheet("E" & i).Value = r.Next(4000, 5000)
workSheet("F" & i).Value = r.Next(5000, 6000)
workSheet("G" & i).Value = r.Next(6000, 7000)
workSheet("H" & i).Value = r.Next(7000, 8000)
workSheet("I" & i).Value = r.Next(8000, 9000)
workSheet("J" & i).Value = r.Next(9000, 10000)
workSheet("K" & i).Value = r.Next(10000, 11000)
workSheet("L" & i).Value = r.Next(11000, 12000)
Next iA2からL11までのすべてのセルには、ランダムに生成されたユニークな値が含まれています。
動的な値について話すと、データベースからセルにデータを動的に追加する方法を学んでみませんか？ 次のコードスニペットは、データベース接続が正しく設定されていることを前提に、これがどのように実行されるかを素早く示します。
4.3. データベースから直接追加 ###
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-6.cs// Create database objects to populate data from database
string contring;
string sql;
DataSet ds = new DataSet("DataSetName");
SqlConnection con;
SqlDataAdapter da;
// Set Database Connection string
contring = @"Data Source=Server_Name;Initial Catalog=Database_Name;User ID=User_ID;Password=Password";
// SQL Query to obtain data
sql = "SELECT Field_Names FROM Table_Name";
// Open Connection & Fill DataSet
con = new SqlConnection(contring);
da = new SqlDataAdapter(sql, con);
con.Open();
da.Fill(ds);
// Loop through contents of dataset
foreach (DataTable table in ds.Tables)
{
int Count = table.Rows.Count - 1;
for (int j = 12; j <= 21; j++)
{
workSheet["A" + j].Value = table.Rows[Count]["Field_Name_1"].ToString();
workSheet["B" + j].Value = table.Rows[Count]["Field_Name_2"].ToString();
workSheet["C" + j].Value = table.Rows[Count]["Field_Name_3"].ToString();
workSheet["D" + j].Value = table.Rows[Count]["Field_Name_4"].ToString();
workSheet["E" + j].Value = table.Rows[Count]["Field_Name_5"].ToString();
workSheet["F" + j].Value = table.Rows[Count]["Field_Name_6"].ToString();
workSheet["G" + j].Value = table.Rows[Count]["Field_Name_7"].ToString();
workSheet["H" + j].Value = table.Rows[Count]["Field_Name_8"].ToString();
workSheet["I" + j].Value = table.Rows[Count]["Field_Name_9"].ToString();
workSheet["J" + j].Value = table.Rows[Count]["Field_Name_10"].ToString();
workSheet["K" + j].Value = table.Rows[Count]["Field_Name_11"].ToString();
workSheet["L" + j].Value = table.Rows[Count]["Field_Name_12"].ToString();
}
Count++;
}' Create database objects to populate data from database
Dim contring As String
Dim sql As String
Dim ds As New DataSet("DataSetName")
Dim con As SqlConnection
Dim da As SqlDataAdapter
' Set Database Connection string
contring = "Data Source=Server_Name;Initial Catalog=Database_Name;User ID=User_ID;Password=Password"
' SQL Query to obtain data
sql = "SELECT Field_Names FROM Table_Name"
' Open Connection & Fill DataSet
con = New SqlConnection(contring)
da = New SqlDataAdapter(sql, con)
con.Open()
da.Fill(ds)
' Loop through contents of dataset
For Each table As DataTable In ds.Tables
Dim Count As Integer = table.Rows.Count - 1
For j As Integer = 12 To 21
workSheet("A" & j).Value = table.Rows(Count)("Field_Name_1").ToString()
workSheet("B" & j).Value = table.Rows(Count)("Field_Name_2").ToString()
workSheet("C" & j).Value = table.Rows(Count)("Field_Name_3").ToString()
workSheet("D" & j).Value = table.Rows(Count)("Field_Name_4").ToString()
workSheet("E" & j).Value = table.Rows(Count)("Field_Name_5").ToString()
workSheet("F" & j).Value = table.Rows(Count)("Field_Name_6").ToString()
workSheet("G" & j).Value = table.Rows(Count)("Field_Name_7").ToString()
workSheet("H" & j).Value = table.Rows(Count)("Field_Name_8").ToString()
workSheet("I" & j).Value = table.Rows(Count)("Field_Name_9").ToString()
workSheet("J" & j).Value = table.Rows(Count)("Field_Name_10").ToString()
workSheet("K" & j).Value = table.Rows(Count)("Field_Name_11").ToString()
workSheet("L" & j).Value = table.Rows(Count)("Field_Name_12").ToString()
Next j
Count += 1
Next table対象のセルに入力するフィールド名をそのセルのValueプロパティに設定するだけです。
5. 書式を適用する ##
5.1. セルの背景色を設定する ###
セルやセル範囲の背景色を設定するには、次のようなコードを一行書くだけです。
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-7.csworkSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")これは、セルの範囲の背景色を灰色に設定します。 色はRGB（赤、緑、青）形式で、最初の2文字が赤、次の2文字が緑、最後の2文字が青を表します。 値は0から9まで、その後AからFまでの範囲です（16進数）。
5.2. 境界線を作成する ###
IronXLを使用して境界線を作成するのはとても簡単です。以下に例を示します:
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-8.csworkSheet["A1:L1"].Style.TopBorder.SetColor("#000000");
workSheet["A1:L1"].Style.BottomBorder.SetColor("#000000");
workSheet["L2:L11"].Style.RightBorder.SetColor("#000000");
workSheet["L2:L11"].Style.RightBorder.Type = IronXL.Styles.BorderType.Medium;
workSheet["A11:L11"].Style.BottomBorder.SetColor("#000000");
workSheet["A11:L11"].Style.BottomBorder.Type = IronXL.Styles.BorderType.Medium;workSheet("A1:L1").Style.TopBorder.SetColor("#000000")
workSheet("A1:L1").Style.BottomBorder.SetColor("#000000")
workSheet("L2:L11").Style.RightBorder.SetColor("#000000")
workSheet("L2:L11").Style.RightBorder.Type = IronXL.Styles.BorderType.Medium
workSheet("A11:L11").Style.BottomBorder.SetColor("#000000")
workSheet("A11:L11").Style.BottomBorder.Type = IronXL.Styles.BorderType.Medium上記のコードでは、セルA1からL1に黒の上と下の境界線を設定し、次にL2からL11のセルに右の境界線を設定し、境界線のスタイルをMediumに設定しました。 最後に、セル A11 から L11 までの下のボーダーを設定しました。
6. セル内で数式を使用する ##
IronXLはすべてをとても簡単にすると何度も言っていますが、本当にその通りです。これを強調せずにはいられません！ 以下のコードにより、数式を使用することができます：
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-9.cs// Use IronXL built-in aggregations
decimal sum = workSheet["A2:A11"].Sum();
decimal avg = workSheet["B2:B11"].Avg();
decimal max = workSheet["C2:C11"].Max();
decimal min = workSheet["D2:D11"].Min();
// Assign value to cells
workSheet["A12"].Value = sum;
workSheet["B12"].Value = avg;
workSheet["C12"].Value = max;
workSheet["D12"].Value = min;' Use IronXL built-in aggregations
Dim sum As Decimal = workSheet("A2:A11").Sum()
Dim avg As Decimal = workSheet("B2:B11").Avg()
Dim max As Decimal = workSheet("C2:C11").Max()
Dim min As Decimal = workSheet("D2:D11").Min()
' Assign value to cells
workSheet("A12").Value = sum
workSheet("B12").Value = avg
workSheet("C12").Value = max
workSheet("D12").Value = minこの素晴らしい点は、セルのデータ型を設定できるため、数式の結果も設定できることです。 上記のコードは、SUM（値を合計）、AVG（値を平均）、MAX（最高値を取得）、MIN（最低値を取得）フォーミュラの使用方法を示しています。
7. ワークシートと印刷プロパティを設定する
7.1. ワークシートのプロパティを設定 ###
ワークシートのプロパティには、行と列を固定することやパスワードでワークシートを保護することが含まれます。 次のように表示されます:
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-10.csworkSheet.ProtectSheet("Password");
workSheet.CreateFreezePane(0, 1);workSheet.ProtectSheet("Password")
workSheet.CreateFreezePane(0, 1)最初の行は固定されており、ワークシートの他の部分と一緒にスクロールされません。 ワークシートはパスワードで保護されており、編集ができません。 図7および図8にその実例が示されています。
Figure 7 – Freeze Panes
Figure 8 – Protected Worksheet
7.2. ページと印刷プロパティの設定 ###
ページのプロパティを設定することができます。たとえば、ページの向き、ページのサイズ、および印刷エリアなどです。
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-11.csworkSheet.SetPrintArea("A1:L12");
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape;
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4;workSheet.SetPrintArea("A1:L12")
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4印刷範囲はA1からL12に設定されます。向きが横向きに設定され、用紙サイズがA4に設定されます。
Figure 9 – Print Setup
8. ワークブックを保存 ##
ブックを保存するには、次のコードを使用します:
:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-12.csworkBook.SaveAs("Budget.xlsx");workBook.SaveAs("Budget.xlsx")チュートリアル クイック アクセス
Download this Tutorial as C# Source Code
The full free C# for Excel Source Code for this tutorial is available to download as a zipped Visual Studio 2017 project file.
DownloadこのチュートリアルをGitHubで探索する
The source code for this project is available in C# and VB.NET on GitHub.
このコードを使用すると、わずか数分で簡単に始められます。このプロジェクトはMicrosoft Visual Studio 2017プロジェクトとして保存されていますが、どの.NET IDEとも互換性があります。
How to Create Excel File in C# on GitHub
