GridView のエクスポートの概要

GridView を Excel ファイルにエクスポートすることは、特にユーザーがアプリケーション外部でデータを分析、共有、またはアーカイブする必要がある場合に、最新の Web アプリケーションで頻繁に必要になります。 GridView データを Excel ファイルに変換することで、Microsoft Excel へのシームレスなインポートが可能になり、ユーザーは使い慣れた環境でデータを簡単に操作できるようになります。 この記事では、さまざまな .NET Web プロジェクトで機能する実用的なソリューションに焦点を当て、GridView を Excel ファイルにエクスポートするための最も効果的な方法について説明します。

プログラムで GridView データを Excel シートにエクスポートするにはどうすればよいですか?

プログラムによって GridView データを Excel ワークシートにエクスポートするには、コントロールからバインドされたデータを抽出し、それを Excel ワークブック構造に書き込む必要があります。 IronXL は、Open XML スプレッドシート形式の複雑さを内部的に処理する直感的な API を提供することで、このエクスポート プロセスを簡素化します。 開発者は、XML スキーマを直接扱うのではなく、ワークブック、ワークシート、行、列などの使い慣れた概念を扱います。

// Quick example: Create an Excel file with IronXL
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Data");
worksheet["A1"].Value = "Hello from IronXL";
workbook.SaveAs("output.xlsx");

// Quick example: Create an Excel file with IronXL
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Data");
worksheet["A1"].Value = "Hello from IronXL";
workbook.SaveAs("output.xlsx");

' Quick example: Create an Excel file with IronXL
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim worksheet As WorkSheet = workbook.CreateWorkSheet("Data")
worksheet("A1").Value = "Hello from IronXL"
workbook.SaveAs("output.xlsx")

注: VB.NET では、通常、 Dim workbookおよびDim worksheetステートメントを使用して、ワークブックとワークシートのオブジェクト初期化が行われます。 これらは、上記の C# オブジェクトの作成に対応しており、 WorkBook workbookとWorkSheet worksheetを使用して Excel オブジェクトを作成および構成します。

ASP.NET プロジェクトで IronXL をセットアップするにはどうすればよいですか?

Visual Studio の NuGet パッケージ マネージャーを使用すると、IronXL のインストールには数秒しかかかりません。 パッケージ マネージャー コンソールを開き、次のコードを実行します。

Install-Package IronXL.Excel

Install-Package IronXL.Excel

! IronXL を使用して GridView を Excel XLSX C# にエクスポート: 画像 2 - インストール

または、ソリューション エクスプローラーでプロジェクトを右クリックし、"NuGet パッケージの管理"を選択して、"IronXL"を検索し、"インストール"をクリックします。 パッケージは、必要なすべての参照と依存関係をプロジェクトに自動的に追加します。 IronXL は、 .NET Framework アプリケーション(4.6.2 以降) に加えて、.NET Core および .NET 5/6/7/8 をサポートしており、さまざまなプロジェクト タイプや Web フォーム構成に柔軟に対応できます。

インストール後、コード ビハインド ファイルに、IronXL 名前空間と System 名前空間を追加します。

using System;
using System.Data;
using IronXL;

using System;
using System.Data;
using IronXL;

Imports System
Imports System.Data
Imports IronXL

GridView を Excel ファイルにエクスポートするにはどうすればよいですか?

次のコードは、ユーザーがエクスポート ボタンをクリックしたときに、ASP.NET GridView コントロールを Excel ファイルにエクスポートする方法を示しています。 この例では、Web フォーム アプリケーションに典型的な完全なクラス構造を使用します。

まず、ASPXマークアップは<asp:GridView>そして<asp:Button>標準の ASP.NET コントロールであるrunat="server"属性を使用します。

<asp:GridView ID="gvEmployees" runat="server" AutoGenerateColumns="true">
</asp:GridView>
<asp:Button ID="btnExport" runat="server" Text="Export to Excel" OnClick="btnExport_Click" />

<asp:GridView ID="gvEmployees" runat="server" AutoGenerateColumns="true">
</asp:GridView>
<asp:Button ID="btnExport" runat="server" Text="Export to Excel" OnClick="btnExport_Click" />

コード ビハインド ファイルには、データ バインディング メソッドとエクスポート ロジックが含まれています。

using System;
using System.Data;
using System.Web.UI;
using IronXL;

public partial class GridViewExport : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            BindGridView();
        }
    }

    private void BindGridView()
    {
        // Create new DataTable as data source
        DataTable dt = new DataTable();
        dt.Columns.Add("EmployeeID", typeof(int));
        dt.Columns.Add("Name", typeof(string));
        dt.Columns.Add("Department", typeof(string));
        dt.Columns.Add("Salary", typeof(decimal));
        dt.Rows.Add(1, "John Smith", "Engineering", 75000);
        dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
        dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
        ViewState["EmployeeData"] = dt;
        gvEmployees.DataSource = dt;
        gvEmployees.DataBind();
    }

    protected void btnExport_Click(object sender, EventArgs e)
    {
        // Create new Excel workbook and worksheet
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Employees");
        for (int j = 0; j < gvEmployees.HeaderRow.Cells.Count; j++)
        {
            worksheet.SetCellValue(0, j, gvEmployees.HeaderRow.Cells[j].Text);
        }
        // Export GridView data to Excel worksheet
        for (int i = 0; i < gvEmployees.Rows.Count; i++)
        {
            for (int j = 0; j < gvEmployees.Rows[i].Cells.Count; j++)
            {
                string cellValue = gvEmployees.Rows[i].Cells[j].Text;
                worksheet.SetCellValue(i + 1, j, cellValue);
            }
        }
        // Save Excel file to server path
        string filename = Server.MapPath("~/Exports/EmployeeData.xlsx");
        workbook.SaveAs(filename);
    }
}

using System;
using System.Data;
using System.Web.UI;
using IronXL;

public partial class GridViewExport : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            BindGridView();
        }
    }

    private void BindGridView()
    {
        // Create new DataTable as data source
        DataTable dt = new DataTable();
        dt.Columns.Add("EmployeeID", typeof(int));
        dt.Columns.Add("Name", typeof(string));
        dt.Columns.Add("Department", typeof(string));
        dt.Columns.Add("Salary", typeof(decimal));
        dt.Rows.Add(1, "John Smith", "Engineering", 75000);
        dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
        dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
        ViewState["EmployeeData"] = dt;
        gvEmployees.DataSource = dt;
        gvEmployees.DataBind();
    }

    protected void btnExport_Click(object sender, EventArgs e)
    {
        // Create new Excel workbook and worksheet
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Employees");
        for (int j = 0; j < gvEmployees.HeaderRow.Cells.Count; j++)
        {
            worksheet.SetCellValue(0, j, gvEmployees.HeaderRow.Cells[j].Text);
        }
        // Export GridView data to Excel worksheet
        for (int i = 0; i < gvEmployees.Rows.Count; i++)
        {
            for (int j = 0; j < gvEmployees.Rows[i].Cells.Count; j++)
            {
                string cellValue = gvEmployees.Rows[i].Cells[j].Text;
                worksheet.SetCellValue(i + 1, j, cellValue);
            }
        }
        // Save Excel file to server path
        string filename = Server.MapPath("~/Exports/EmployeeData.xlsx");
        workbook.SaveAs(filename);
    }
}

この実装では、エクスポート ボタンがクリックされたときに新しいWorkBookインスタンスが作成されます。 ネストされたループは、行インデックスとしてint iを使用して各 GridView 行を反復処理し、 SetCellValue メソッドを使用して対応する Excel ワークシートの位置にセル値を書き込みます。

列ヘッダーと基本的な書式設定を追加するにはどうすればいいですか?

前の例では、データ行はエクスポートされますが、列ヘッダーは省略されます。 この拡張バージョンには、GridView から抽出されたヘッダーが含まれており、出力 Excel ファイルの読みやすさを向上させるために基本的な書式設定が適用されます。

protected void btnExport_Click(object sender, EventArgs e)
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.CreateWorkSheet("Employees");
    // Write column headers from GridView to Excel sheet
    int columnCount = gvEmployees.HeaderRow.Cells.Count;
    for (int i = 0; i < columnCount; i++)
    {
        string headerText = gvEmployees.HeaderRow.Cells[i].Text;
        worksheet.SetCellValue(0, i, headerText);
    }
    // Write data rows starting from row 1
    int rowCount = gvEmployees.Rows.Count;
    for (int i = 0; i < rowCount; i++)
    {
        for (int j = 0; j < gvEmployees.Rows[i].Cells.Count; j++)
        {
            string cellValue = gvEmployees.Rows[i].Cells[j].Text;
            worksheet.SetCellValue(i + 1, j, cellValue);
        }
    }
    // Apply column auto-fit formatting for better display
    worksheet.AutoSizeColumn(0);
    worksheet.AutoSizeColumn(1);
    worksheet.AutoSizeColumn(2);
    worksheet.AutoSizeColumn(3);
    string filename = Server.MapPath("~/Exports/EmployeeReport.xlsx");
    workbook.SaveAs(filename);
}

protected void btnExport_Click(object sender, EventArgs e)
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.CreateWorkSheet("Employees");
    // Write column headers from GridView to Excel sheet
    int columnCount = gvEmployees.HeaderRow.Cells.Count;
    for (int i = 0; i < columnCount; i++)
    {
        string headerText = gvEmployees.HeaderRow.Cells[i].Text;
        worksheet.SetCellValue(0, i, headerText);
    }
    // Write data rows starting from row 1
    int rowCount = gvEmployees.Rows.Count;
    for (int i = 0; i < rowCount; i++)
    {
        for (int j = 0; j < gvEmployees.Rows[i].Cells.Count; j++)
        {
            string cellValue = gvEmployees.Rows[i].Cells[j].Text;
            worksheet.SetCellValue(i + 1, j, cellValue);
        }
    }
    // Apply column auto-fit formatting for better display
    worksheet.AutoSizeColumn(0);
    worksheet.AutoSizeColumn(1);
    worksheet.AutoSizeColumn(2);
    worksheet.AutoSizeColumn(3);
    string filename = Server.MapPath("~/Exports/EmployeeReport.xlsx");
    workbook.SaveAs(filename);
}

HeaderRowプロパティは、Excel ワークシートの行 0 に書き込まれる GridView の列ヘッダーへのアクセスを提供します。 次に、データ行が 1 行目から入力されます ( SetCellValue呼び出しのi + 1オフセットに注意してください)。 このオフセットは、ヘッダー行がデータで上書きされるのを防ぐために不可欠です。

ViewState を使用してデータをエクスポートするにはどうすればよいですか?

GridViewコントロールがDataTableにバインドされている場合、 DataSourceに直接アクセスすると、ユーザー インターフェイスの HTML 要素を反復処理するよりもクリーンなコードと優れたパフォーマンスが実現します。

protected void btnExport_Click(object sender, EventArgs e)
{
    // Cast DataSource to DataTable
    DataTable sourceData = ViewState["EmployeeData"] as DataTable;
    if (sourceData == null)
        return; // or show error
    // In VB.NET, this would be declared as: Dim dt As DataTable
    // Create new workbook and worksheet
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.CreateWorkSheet("Report");
    // Write headers from DataTable columns
    for (int i = 0; i < sourceData.Columns.Count; i++)
    {
        worksheet.SetCellValue(0, i, sourceData.Columns[i].ColumnName);
    }
    // Write data rows to Excel
    for (int i = 0; i < sourceData.Rows.Count; i++)
    {
        for (int j = 0; j < sourceData.Columns.Count; j++)
        {
            worksheet.SetCellValue(i + 1, j, sourceData.Rows[i][j].ToString());
        }
    }
    string filename = Server.MapPath("~/Exports/DataExport.xlsx");
    workbook.SaveAs(filename);
}

protected void btnExport_Click(object sender, EventArgs e)
{
    // Cast DataSource to DataTable
    DataTable sourceData = ViewState["EmployeeData"] as DataTable;
    if (sourceData == null)
        return; // or show error
    // In VB.NET, this would be declared as: Dim dt As DataTable
    // Create new workbook and worksheet
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.CreateWorkSheet("Report");
    // Write headers from DataTable columns
    for (int i = 0; i < sourceData.Columns.Count; i++)
    {
        worksheet.SetCellValue(0, i, sourceData.Columns[i].ColumnName);
    }
    // Write data rows to Excel
    for (int i = 0; i < sourceData.Rows.Count; i++)
    {
        for (int j = 0; j < sourceData.Columns.Count; j++)
        {
            worksheet.SetCellValue(i + 1, j, sourceData.Rows[i][j].ToString());
        }
    }
    string filename = Server.MapPath("~/Exports/DataExport.xlsx");
    workbook.SaveAs(filename);
}

Protected Sub btnExport_Click(sender As Object, e As EventArgs)
    ' Cast DataSource to DataTable
    Dim sourceData As DataTable = TryCast(ViewState("EmployeeData"), DataTable)
    If sourceData Is Nothing Then
        Return ' or show error
    End If
    ' In VB.NET, this would be declared as: Dim dt As DataTable
    ' Create new workbook and worksheet
    Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
    Dim worksheet As WorkSheet = workbook.CreateWorkSheet("Report")
    ' Write headers from DataTable columns
    For i As Integer = 0 To sourceData.Columns.Count - 1
        worksheet.SetCellValue(0, i, sourceData.Columns(i).ColumnName)
    Next
    ' Write data rows to Excel
    For i As Integer = 0 To sourceData.Rows.Count - 1
        For j As Integer = 0 To sourceData.Columns.Count - 1
            worksheet.SetCellValue(i + 1, j, sourceData.Rows(i)(j).ToString())
        Next
    Next
    Dim filename As String = Server.MapPath("~/Exports/DataExport.xlsx")
    workbook.SaveAs(filename)
End Sub

この方法では、 DataTableのColumnsコレクションから列名を直接抽出し、 DataRowオブジェクトからセル値を取得します。 基になるデータ ソースを操作すると、 GridViewレンダリングへの依存がなくなり、コントロールの表示状態、ページング構成、または既定の表示設定に関係なく、一貫した結果が得られます。

エラーと出力の処理

GridView Excel ファイルにエクスポートする場合、エクスポート プロセスが信頼性が高く、ユーザーフレンドリーであることを確認することが重要です。 エラーは、ファイルの権限の問題、無効なデータ、予期しない例外など、さまざまな理由で発生する可能性があるため、堅牢なエラー処理が不可欠です。 エクスポート ロジックを try-catch ブロックでラップすることで、発生する問題を適切に処理し、ユーザーに明確なフィードバックを提供できます。

さらに、エクスポート プロセスの出力をカスタマイズすると、ユーザー エクスペリエンスが向上します。 ファイル名を指定し、適切なファイル形式を選択し、コンテンツ配置を設定して、Excel ファイルがユーザーに配信される方法 (ダウンロード添付ファイルとしてなど) を制御できます。

次のコードは、 GridViewを Excel ファイルにエクスポートするときにエラーと出力を処理する方法を示しています。

try
{
    // Export GridView to Excel file
    GridViewExport.ExcelExport(GridView1, "ExportedData");
    Response.Write("Export successful! Your Excel file is ready.");
}
catch (Exception ex)
{
    // Handle exception and inform the user
    Response.Write("Error exporting data: " + ex.Message);
}

try
{
    // Export GridView to Excel file
    GridViewExport.ExcelExport(GridView1, "ExportedData");
    Response.Write("Export successful! Your Excel file is ready.");
}
catch (Exception ex)
{
    // Handle exception and inform the user
    Response.Write("Error exporting data: " + ex.Message);
}

Try
    ' Export GridView to Excel file
    GridViewExport.ExcelExport(GridView1, "ExportedData")
    Response.Write("Export successful! Your Excel file is ready.")
Catch ex As Exception
    ' Handle exception and inform the user
    Response.Write("Error exporting data: " & ex.Message)
End Try

この例では、エクスポート プロセスは try-catch ブロックでラップされています。 エクスポートが成功すると、ユーザーに確認メッセージが表示されます。 エラーが発生した場合、catch ブロックは例外をキャプチャし、エラー メッセージを出力して、ユーザーにエクスポートのステータスが通知されるようにします。 ファイル名、ファイルの種類、コンテンツ配置ヘッダーを設定して、ダウンロード中に Excel ファイルがユーザーにどのように表示されるかを制御することで、出力をさらにカスタマイズできます。

結論

IronXL を使用すると、ASP.NET GridViewデータを Excel ファイルにエクスポートすることが簡単になります。 ライブラリは、サーバー上の MS Excel または Microsoft Office に依存することなく、ワークブックの作成、セルの作成、およびファイルの生成を処理します。 このため、IronXL は、サーバー側での Excel 生成がさまざまなホスティング環境間で確実に動作する必要がある Web アプリケーションに特に適しています。

この記事の例では、基本的なエクスポートから列ヘッダーや書式設定の追加まで段階的に構築する方法を示します。 最後の例に示すDataTableアプローチは、 GridView構成に関係なくデータの整合性を確保しながら、運用中の .NET アプリケーションに最も堅牢なソリューションを提供します。 IronXL の包括的な機能セットは、既存の Excel ファイルの読み取り、数式の操作、より複雑なレポート シナリオのための複数のワークシートの管理もサポートします。 ライブラリは XLSX および XLS 形式をネイティブに処理し、必要に応じて CSV 出力を書き込むこともできます。

今すぐ無料トライアルを開始して、ASP.NET アプリケーションにGridViewから Excel へのエクスポートを実装してください。 実稼働環境で使用する場合は、専用サポート付きの永久ライセンスを含むIronXL ライセンス オプションを検討してください。