L'importation de données Excel dans un GridView en ASP.NET C# est simple avec IronXL . Vous chargez un classeur, convertissez une feuille de calcul en DataTable, et la liez à votre contrôle GridView - tout cela sans pilotes OLEDB ou chaînes de connexion complexes.
> Essayez-le vous-même : profitez d'un essai gratuit d' IronXL pour suivre les exemples de code ci-dessous.
Avant d'écrire le moindre code, vous devez ajouter IronXL à votre projet ASP.NET . La méthode la plus rapide consiste à NuGet, soit via la console du gestionnaire de packages Visual Studio, soit via l'interface de ligne de commande .NET .
Une fois installé, NuGet ajoute toutes les références nécessaires à votre projet. Aucun pilote externe à installer, aucun fournisseur OLEDB à enregistrer et aucune dépendance à Microsoft Office sur le serveur. La bibliothèque est distribuée sous forme d'un seul assemblage géré et fonctionne sous Windows, Linux, macOS et dans les environnements d'hébergement cloud, notamment Azure App Service.
Après l'installation, ajoutez les espaces de noms suivants à tout fichier code-behind qui lit ou écrit des données Excel :
using IronXL;
using System.Data;
using System.IO;Imports IronXL
Imports System.Data
Imports System.IOIronXL prend en charge les formats .xls (Excel 97-2003) et .xlsx (Excel 2007+), vous n'avez donc pas besoin de gestion distincte pour chaque type de fichier. Le même appel WorkBook.Load gère les deux formats en inspectant automatiquement la signature du fichier.
Les importations Excel traditionnelles basées sur OLEDB nécessitent le moteur de base de données Microsoft Access (ACE ou JET) , qui doit être installé sur le serveur dans la version appropriée (32 bits ou 64 bits). Le déploiement sur différents environnements serveur échoue souvent car le pilote est manquant ou incompatible, et Microsoft ne fournit plus par défaut le pilote ACE 64 bits avec Windows.
IronXL élimine complètement cette dépendance. Il lit directement le format Open XML ou BIFF brut dans le code managé. Vous bénéficiez d'un comportement prévisible en développement, en préproduction et en production, sans vous soucier des versions de pilotes.
IronXL cible .NET 10, .NET 8, .NET Standard 2.0 et .NET Framework 4.6.2+. Cette compatibilité signifie que vous pouvez utiliser la même bibliothèque, que votre application ASP.NET s'exécute sur Web Forms classique, ASP.NET MVC ou sur les pages Razor ASP.NET Core modernes, sans aucune modification de code au niveau de la couche de gestion Excel. Vous pouvez trouver le package IronXL sur NuGet pour consulter l'historique des versions et les notes de version avant l'installation.
La méthode la plus rapide combine WorkBook.Load, sheet.ToDataTable, et GridView.DataBind en environ quatre lignes de code efficace. Dans les scénarios de base, aucune création manuelle de colonnes ni aucune itération de lignes ne sont nécessaires.
using IronXL;
using System.Data;
WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;
// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);
GridView1.DataSource = dataTable;
GridView1.DataBind();Imports IronXL
Imports System.Data
Dim workBook As WorkBook = WorkBook.Load("data.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet
' True = treat first row as column headers
Dim dataTable As DataTable = sheet.ToDataTable(True)
GridView1.DataSource = dataTable
GridView1.DataBind()L'appel ToDataTable(true) indique à IronXL de promouvoir la première ligne de la feuille de calcul en noms de colonnes dans le DataTable résultant. Lorsque vous liez cette table à un GridView avec AutoGenerateColumns="true", ASP.NET crée automatiquement une colonne par en-tête Excel.
Chaque valeur de cellule dans le DataTable est stockée en tant que string par défaut lorsque vous appelez ToDataTable. Si votre application nécessite des colonnes typées -- par exemple, decimal pour des données de prix ou DateTime pour des dates -- vous pouvez lire les valeurs de cellule individuellement via l'indexeur WorkSheet et les convertir au type .NET approprié avant de remplir un DataTable fortement typé.
Pour l'affichage simple dans un GridView, les colonnes de chaîne sont suffisantes car le tableau rend toutes les valeurs sous forme de texte de toute façon.
Une page d'importation minimale nécessite trois contrôles : une entrée de téléchargement de fichier, un bouton de soumission, et le GridView. Ajoutez le balisage ASPX suivant à l'intérieur de votre élément <form runat="server"> :
<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
CssClass="table table-bordered" /><asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File" OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true" CssClass="table table-bordered" />L'attribut CssClass connecte la grille à votre feuille de style Bootstrap si vous en utilisez une, vous offrant des lignes et des bordures stylisées sans configuration supplémentaire.
Dans le code-behind, gérez l'événement de clic sur le bouton. Le modèle ci-dessous enregistre le fichier téléchargé dans un chemin serveur temporaire, le charge avec IronXL, et lie le DataTable résultant à la grille :
using IronXL;
using System.Data;
using System.IO;
void btnUpload_Click(object sender, EventArgs e)
{
if (!FileUpload1.HasFile) return;
string uploadDir = Server.MapPath("~/Uploads/");
Directory.CreateDirectory(uploadDir); // ensure directory exists
string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
FileUpload1.SaveAs(filePath);
WorkBook workBook = WorkBook.Load(filePath);
WorkSheet sheet = workBook.DefaultWorkSheet;
DataTable dt = sheet.ToDataTable(true);
GridView1.DataSource = dt;
GridView1.DataBind();
// Store for later export operations
Session["CurrentData"] = dt;
}Imports IronXL
Imports System.Data
Imports System.IO
Sub btnUpload_Click(sender As Object, e As EventArgs)
If Not FileUpload1.HasFile Then Return
Dim uploadDir As String = Server.MapPath("~/Uploads/")
Directory.CreateDirectory(uploadDir) ' ensure directory exists
Dim filePath As String = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName))
FileUpload1.SaveAs(filePath)
Dim workBook As WorkBook = WorkBook.Load(filePath)
Dim sheet As WorkSheet = workBook.DefaultWorkSheet
Dim dt As DataTable = sheet.ToDataTable(True)
GridView1.DataSource = dt
GridView1.DataBind()
' Store for later export operations
Session("CurrentData") = dt
End SubCette implémentation suit le style des instructions de niveau supérieur pour la logique à l'intérieur du gestionnaire d'événements tout en conservant la signature d'événement Web Forms requise. Nontez que Directory.CreateDirectory est appelé de manière défensive - si le dossier Uploads existe déjà, l'appel n'a aucun effet.
Après que l'utilisateur sélectionne un fichier .xlsx et clique sur le bouton de téléchargement, la grille se remplit avec le contenu de la feuille de calcul. Les noms des colonnes proviennent de la première ligne du fichier Excel, et toutes les lignes suivantes deviennent des lignes de données dans la grille.
Pour une utilisation en production, vous devez vérifier l'extension du fichier et le type MIME avant de le traiter. IronXL générera une exception pour les formats de fichiers non pris en charge, mais il est préférable de rejeter les chargements incorrects au niveau du contrôleur avant de toucher au système de fichiers :
string ext = Path.GetExtension(FileUpload1.FileName).ToFaibleerInvariant();
string[] allowed = { ".xls", ".xlsx" };
if (!allowed.Contains(ext))
{
lblError.Text = "Only .xls and .xlsx files are accepted.";
return;
}Imports System.IO
Dim ext As String = Path.GetExtension(FileUpload1.FileName).ToLowerInvariant()
Dim allowed As String() = {".xls", ".xlsx"}
If Not allowed.Contains(ext) Then
lblError.Text = "Only .xls and .xlsx files are accepted."
Return
End IfVous devez également appliquer une taille de fichier maximale via les limites de requête IIS ou en vérifiant FileUpload1.FileBytes.Length contre un seuil avant d'appeler SaveAs.
Lorsque qu'un classeur Excel contient plusieurs feuilles, vous devez cibler une feuille spécifique par nom plutôt que de vous fier à DefaultWorkSheet. IronXL fournit une méthode GetWorkSheet qui accepte le nom d'onglet de la feuille sous forme de chaîne.
using IronXL;
using System.Data;
WorkBook workBook = WorkBook.Load("sales-report.xlsx");
// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");
// Read a specific cell range
var topTen = salesSheet["A1:E11"];
// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();
// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();Imports IronXL
Imports System.Data
Dim workBook As WorkBook = WorkBook.Load("sales-report.xlsx")
' Access a named sheet
Dim salesSheet As WorkSheet = workBook.GetWorkSheet("Q4 Sales")
' Read a specific cell range
Dim topTen = salesSheet("A1:E11")
' Convert the entire workbook to a DataSet (one DataTable per sheet)
Dim allSheets As DataSet = workBook.ToDataSet()
' Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables(0)
GridView1.DataBind()La méthode ToDataSet est utile lorsque votre application a besoin d'afficher des données de plusieurs feuilles ou de laisser l'utilisateur choisir quelle feuille afficher. Chaque DataTable dans le DataSet retourné correspond à une feuille de calcul Excel, et le nom de la table correspond au nom de l'onglet de feuille.
Si vous ne voulez qu'un sous-ensemble de lignes Excel -- par exemple, les lignes où la colonne "Statut" égale "Actif" -- lisez le DataTable produit par ToDataTable, appliquez un filtre DataView, et liez la vue filtrée à la grille :
DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
RowFilter = "Status = 'Active'"
};
GridView1.DataSource = dv;
GridView1.DataBind();Dim dt As DataTable = sheet.ToDataTable(True)
Dim dv As New DataView(dt) With {
.RowFilter = "Status = 'Active'"
}
GridView1.DataSource = dv
GridView1.DataBind()DataView.RowFilter accepte la syntaxe standard de clause SQL WHERE -- le même langage d'expression documenté dans la propriété DataColumn.Expression sur Microsoft Learn -- vous offrant tri et filtrage sans charger de base de données.
Les différentes approches de liaison d'Excel à GridView présentent des compromis distincts. Le tableau ci-dessous récapitule les méthodes les plus courantes afin que vous puissiez choisir celle qui convient le mieux à votre situation.
| Méthode | Chauffeur requis | Prise en charge XLS | Assistance XLSX | Dépendance du serveur | Complexité du code |
|---|---|---|---|---|---|
| IronXL (ToDataTable) | Nonne | Oui | Oui | Nonne | Faible |
| OLEDB / JET | Moteur ACE/JET | Oui | Partiel | Pilote 32/64 bits | Haut |
| Open XML SDK | Nonne | Non | Oui | Nonne | Haut |
| EPPlus | Nonne | Non | Oui | Aucune (licence commerciale requise pour la production) | Moyen |
IronXL prend en charge les formats XLS anciens et XLSX modernes, ne nécessite aucune installation de pilote côté serveur et offre la complexité de code la plus faible parmi les options listées. Pour les équipes qui utilisent déjà d'autres produits Iron Software tels IronPDF ou IronOCR , une seule licence Iron Software couvre la Suite complète.
Effectuer l'aller-retour (d'Excel vers une grille puis retour à Excel) est tout aussi concis avec IronXL. Ce modèle est utile pour les boutons " télécharger au format Excel " qui permettent aux utilisateurs d'exporter ce qui est actuellement affiché dans la grille.
void btnExport_Click(object sender, EventArgs e)
{
DataTable dt = Session["CurrentData"] as DataTable;
if (dt == null) return;
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet ws = workBook.CreateWorkSheet("Export");
// Write header row
for (int col = 0; col < dt.Columns.Count; col++)
ws.SetCellValue(0, col, dt.Columns[col].ColumnName);
// Write data rows
for (int row = 0; row < dt.Rows.Count; row++)
for (int col = 0; col < dt.Columns.Count; col++)
ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
string exportDir = Server.MapPath("~/Exports/");
Directory.CreateDirectory(exportDir);
string exportPath = Path.Combine(exportDir, "export.xlsx");
workBook.SaveAs(exportPath);
Response.Clear();
Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
Response.TransmitFile(exportPath);
Response.End();
}Imports System
Imports System.Data
Imports System.IO
Sub btnExport_Click(sender As Object, e As EventArgs)
Dim dt As DataTable = TryCast(Session("CurrentData"), DataTable)
If dt Is Nothing Then Return
Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim ws As WorkSheet = workBook.CreateWorkSheet("Export")
' Write header row
For col As Integer = 0 To dt.Columns.Count - 1
ws.SetCellValue(0, col, dt.Columns(col).ColumnName)
Next
' Write data rows
For row As Integer = 0 To dt.Rows.Count - 1
For col As Integer = 0 To dt.Columns.Count - 1
ws.SetCellValue(row + 1, col, If(dt.Rows(row)(col)?.ToString(), String.Empty))
Next
Next
Dim exportDir As String = Server.MapPath("~/Exports/")
Directory.CreateDirectory(exportDir)
Dim exportPath As String = Path.Combine(exportDir, "export.xlsx")
workBook.SaveAs(exportPath)
Response.Clear()
Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx")
Response.TransmitFile(exportPath)
Response.End()
End SubL'appel Response.TransmitFile diffuse le fichier enregistré au navigateur, ce qui déclenche une boîte de dialogue de téléchargement. L'en-tête Content-Disposition: attachment garantit que les navigateurs téléchargent plutôt que d'essayer d'afficher le fichier en ligne.
Au-delà des données brutes, IronXL vous permet d'appliquer une mise en forme aux cellules avant l'enregistrement. Vous pouvez définir des en-têtes en gras, la largeur des colonnes, le format des nombres et les couleurs d'arrière-plan :
// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;
// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXL.Styles.BuiltinFormats.Accounting2;
// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);' Bold the header row
ws("A1:Z1").Style.Font.Bold = True
' Apply a currency format to column C (index 2), rows 2 onward
ws($"C2:C{dt.Rows.Count + 1}").FormatString = IronXL.Styles.BuiltinFormats.Accounting2
' Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0)
ws.AutoSizeColumn(1)Ces appels de formatage utilisent l'API de style de cellule IronXL, qui imite le modèle objet du format de fichier Excel sans nécessiter d'Interop.
Vous disposez désormais d'un pipeline complet et sans pilote pour importer des fichiers Excel dans un GridView ASP.NET et exporter les données du GridView vers Excel à l'aide IronXL. Voici les pistes à explorer ensuite pour consolider ces bases :
Pour les applications .NET Core et ASP.NET Core , la même API IronXL fonctionne dans les Razor Pages et les contrôleurs MVC. Le guide ASP.NET Core de IronXL explique les différences dans la gestion des téléchargements de fichiers et les modèles d'injection de dépendances.
Commencez par l'essai gratuit d'IronXL pour tester toutes les fonctionnalités dans votre projet avant de l'acheter. Aucune carte de crédit n'est requise pour la licence d'essai.
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronXL fait partie de IRONSUITE
10 API .NET pour vos documents
L'API Excel dont vous avez besoin, sans tracas Interop Office.
