VB .NET Excel Geler la première ligne : Garder les en-têtes visibles pendant le défilement

Comment installer IronXL pour votre projet .NET ?

Avant d'écrire le moindre code de gel de volet, ajoutez IronXL à votre projet à l'aide du gestionnaire de packages NuGet . Ouvrez votre terminal et exécutez :

dotnet add package IronXL.Excel

dotnet add package IronXL.Excel

Vous pouvez également utiliser la console du gestionnaire de packages de Visual Studio :

Install-Package IronXL.Excel

Install-Package IronXL.Excel

Après l'installation, ajoutez l'espace de noms IronXL en haut de votre fichier. IronXL cible .NET 10 et prend en charge toutes les principales plateformes (Windows, Linux et macOS), ce qui garantit le bon fonctionnement de votre logique de gel des volets, quel que soit l'environnement de déploiement.

Une fois installé, vous pouvez charger des classeurs existants ou en créer de nouveaux en quelques lignes seulement. La bibliothèque fonctionne avec les formats .xlsx (Excel 2007 et versions ultérieures) et .xls (Excel 97-2003), bien que la prise en charge du gel des volets nécessite le format moderne .xlsx. Le tableau ci-dessous résume les principales méthodes WorkSheet abordées dans ce guide.

Comment figer des lignes dans un fichier Excel ?

La réponse est simple : utilisez la méthode CreateFreezePane sur votre objet feuille de calcul. Cette méthode accepte des paramètres qui contrôlent les lignes et les colonnes qui restent visibles tandis que le reste de la feuille Excel défile librement. Lorsque vous figez la première ligne, votre en-tête reste verrouillé en haut, quelle que soit la profondeur à laquelle vous faites défiler les données, de la même manière que la fonction native " Figer les volets " d'Excel.

L'extrait de code suivant montre comment charger un document Excel existant et figer la première ligne :

using IronXL;
using System.Linq;

// Load an existing workbook from file
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1);

// Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx");

using IronXL;
using System.Linq;

// Load an existing workbook from file
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1);

// Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx");

Comment figer la première colonne dans Excel ?

Pour figer la première colonne au lieu des lignes, ajustez les paramètres dans la méthode CreateFreezePane. Ceci est utile lorsque votre feuille de calcul Excel contient des informations d'identification dans la colonne A que vous souhaitez garder visibles lors du défilement des colonnes supplémentaires vers la droite.

L'extrait de code suivant montre comment créer un nouveau classeur et figer la première colonne :

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("SalesData");

// Add sample header and data to the range
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Q1 Sales";
workSheet["C1"].Value = "Q2 Sales";
workSheet["D1"].Value = "Q3 Sales";
workSheet["E1"].Value = "Q4 Sales";

// Populate a few rows of sample data
workSheet["A2"].Value = "PROD-001";
workSheet["B2"].Value = 14500;
workSheet["A3"].Value = "PROD-002";
workSheet["B3"].Value = 21300;

// Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0);

// Save as xlsx file
workBook.SaveAs("SalesReport.xlsx");

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("SalesData");

// Add sample header and data to the range
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Q1 Sales";
workSheet["C1"].Value = "Q2 Sales";
workSheet["D1"].Value = "Q3 Sales";
workSheet["E1"].Value = "Q4 Sales";

// Populate a few rows of sample data
workSheet["A2"].Value = "PROD-001";
workSheet["B2"].Value = 14500;
workSheet["A3"].Value = "PROD-002";
workSheet["B3"].Value = 21300;

// Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0);

// Save as xlsx file
workBook.SaveAs("SalesReport.xlsx");

Comment figer simultanément les lignes et les colonnes ?

Pour les applications traitant des documents Excel complexes, il peut être nécessaire de figer les volets en verrouillant simultanément la première ligne et la première colonne. Cela permet de conserver la visibilité des étiquettes d'en-tête et des identifiants de ligne quelle que soit la direction de défilement, facilitant ainsi la compréhension et le filtrage des données de vos cellules .

using IronXL;

// Load workbook or create a new one
WorkBook workBook = WorkBook.Load("Inventory.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1);

// Save the document
workBook.SaveAs("Inventory_Frozen.xlsx");

using IronXL;

// Load workbook or create a new one
WorkBook workBook = WorkBook.Load("Inventory.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1);

// Save the document
workBook.SaveAs("Inventory_Frozen.xlsx");

Comment utiliser la méthode avancée de gel des volets avec pré-défilement ?

IronXL propose une option avancée utilisant quatre paramètres qui vous permet d'ajouter des panneaux figés avec une position de départ pré-déroulée. Cela permet de contrôler non seulement les lignes et les colonnes figées, mais aussi l'endroit où commence la zone de défilement lorsque les utilisateurs ouvrent le fichier pour la première fois.

Ceci est utile pour les tableaux de bord ou les rapports de direction où vous souhaitez que la vue initiale s'affiche sur une section de données spécifique, par exemple, afficher immédiatement les données de ce mois-ci tout en conservant la ligne d'en-tête et la colonne d'ID figées visibles.

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("LargeDataset.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze columns A-B and rows 1-3
// Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7);

workBook.SaveAs("LargeDataset_Configured.xlsx");

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("LargeDataset.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze columns A-B and rows 1-3
// Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7);

workBook.SaveAs("LargeDataset_Configured.xlsx");

Comment supprimer les volets figés d'une feuille de calcul ?

Si des volets figés existent déjà et que vous devez les supprimer, la méthode RemovePane gère cela proprement. Ceci est utile lorsque vous devez installer une configuration de gel différente ou rétablir le défilement normal de la feuille.

// Remove all existing freeze or split panes
workSheet.RemovePane();

// Remove all existing freeze or split panes
workSheet.RemovePane();

Cette simple ligne supprime tous les volets figés présents dans la feuille de calcul, vous permettant ainsi de créer une nouvelle mise en forme ou de laisser le document sans sections figées. Après avoir appelé RemovePane, vous pouvez immédiatement appeler à nouveau CreateFreezePane avec de nouveaux paramètres -- les deux opérations s'enchaînent naturellement.

Notez que le gel des volets ne fonctionne pas avec le format Microsoft Excel 97-2003 (.xls) en raison des limitations du format de fichier. Pour de meilleurs résultats, enregistrez vos documents au format .xlsx. Si vous rencontrez un problème d'affichage des volets figés dans les fichiers téléchargés, vérifiez que vous utilisez une version compatible d'Excel et que le fichier est enregistré au format moderne.

Vous pouvez également associer la suppression du gel du volet à d'autres opérations sur la feuille de calcul. Par exemple, avant d'exporter un rapport vers une mise en page différente, vous pouvez supprimer la configuration de gel, ajouter de nouvelles lignes et colonnes , restructurer les données, puis appliquer une nouvelle configuration de gel correspondant à la mise en page mise à jour.

Comment appliquer le gel des volets à plusieurs feuilles de calcul ?

De nombreux classeurs Excel contiennent plusieurs feuilles de calcul : une par département, région ou période. L'application programmatique du gel des volets à chaque feuille permet de gagner du temps par rapport à une opération manuelle dans l'application Excel.

L'exemple suivant charge un classeur, parcourt toutes les feuilles de calcul et applique la même configuration de gel à chacune d'elles :

using IronXL;

WorkBook workBook = WorkBook.Load("MultiSheetReport.xlsx");

// Apply freeze panes to every worksheet in the workbook
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    // Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1);
}

workBook.SaveAs("MultiSheetReport_Frozen.xlsx");

using IronXL;

WorkBook workBook = WorkBook.Load("MultiSheetReport.xlsx");

// Apply freeze panes to every worksheet in the workbook
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    // Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1);
}

workBook.SaveAs("MultiSheetReport_Frozen.xlsx");

Ce modèle est particulièrement pratique pour les rapports financiers trimestriels, où chaque feuille représente un mois, ou pour les rapports de ventes multirégionaux où chaque région dispose de son propre onglet. En combinant le tri des données de plages Excel et l'application d'une mise en forme conditionnelle , vous pouvez créer des classeurs entièrement formatés et prêts à être partagés, entièrement à partir de code.

IronXL vous donne également accès au modèle objet WorkBook pour une inspection plus approfondie des classeurs. Vous pouvez vérifier le nombre de feuilles, récupérer des feuilles par nom ou par index et appliquer différentes configurations de gel à différentes feuilles en fonction de leur type de contenu ; par exemple, une feuille de synthèse peut ne geler que la première ligne, tandis que les feuilles de détail gèlent à la fois une ligne et une colonne.

Comment valider les paramètres de gel du volet avant l'enregistrement ?

Dans le code de production, il est recommandé de vérifier la configuration du volet de gel avant d'écrire le fichier sur le disque. IronXL n'expose actuellement pas d'API de lecture directe pour l'état de gel des volets ; l'approche recommandée consiste donc à suivre la configuration dans votre propre code et à vérifier que l'opération d'enregistrement se termine sans erreur.

Voici un modèle de programmation défensive que vous pouvez appliquer dans n'importe quel projet .NET 10 :

using IronXL;
using System;

try
{
    WorkBook workBook = WorkBook.Load("source.xlsx");
    WorkSheet workSheet = workBook.DefaultWorkSheet;

    int freezeCol = 1;
    int freezeRow = 1;

    if (freezeCol >= 0 && freezeRow >= 0)
    {
        workSheet.CreateFreezePane(freezeCol, freezeRow);
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).");
    }
    else
    {
        Console.WriteLine("Invalid freeze pane parameters -- skipping.");
    }

    workBook.SaveAs("output.xlsx");
    Console.WriteLine("Workbook saved successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Error applying freeze pane: {ex.Message}");
}

using IronXL;
using System;

try
{
    WorkBook workBook = WorkBook.Load("source.xlsx");
    WorkSheet workSheet = workBook.DefaultWorkSheet;

    int freezeCol = 1;
    int freezeRow = 1;

    if (freezeCol >= 0 && freezeRow >= 0)
    {
        workSheet.CreateFreezePane(freezeCol, freezeRow);
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).");
    }
    else
    {
        Console.WriteLine("Invalid freeze pane parameters -- skipping.");
    }

    workBook.SaveAs("output.xlsx");
    Console.WriteLine("Workbook saved successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Error applying freeze pane: {ex.Message}");
}

Ce modèle valide les paramètres avant d'appeler l'API et encapsule l'opération d'enregistrement dans un bloc try-catch afin que toute erreur de système de fichiers ou de format soit correctement interceptée. Pour la génération de rapports côté serveur, ce type de code de défense empêche les défaillances silencieuses dans les pipelines de traitement par lots.

Vous trouverez d'autres modèles pour travailler avec des feuilles de calcul Excel et créer des graphiques Excel dans la documentation IronXL , qui couvre toute la gamme des opérations de tableur prises en charge par la bibliothèque.

Comment combiner la fonction de gel des vitres avec les autres fonctionnalités IronXL ?

Les volets figés deviennent encore plus précieux lorsqu'ils sont combinés à d'autres opérations de mise en forme et de traitement des données dans une feuille de calcul. Les combinaisons les plus courantes dans les applications .NET réelles sont les suivantes :

Mise en forme des en-têtes avec des volets figés. Figez la première ligne, puis appliquez une mise en forme en gras, une couleur d'arrière-plan ou des styles de bordure aux cellules d'en-tête afin qu'elles se distinguent clairement des lignes de données situées en dessous. Les utilisateurs remarquent immédiatement que la ligne figée est un en-tête et non une ligne de données.

Largeur des colonnes ajustée automatiquement. Après la saisie des données, la largeur des colonnes s'ajuste automatiquement afin que chaque colonne soit exactement assez large pour son contenu. Cela élimine le texte tronqué et rend les en-têtes figés lisibles en un coup d'œil.

Validation des données et protection des cellules. Combinez le gel des volets avec la protection des cellules pour verrouiller les cellules d'en-tête et empêcher toute modification accidentelle. Les utilisateurs finaux peuvent faire défiler les données et interagir avec elles tandis que la ligne d'en-tête protégée reste figée et en lecture seule.

Tri et filtrage. Appliquez le filtre automatique Excel à la ligne d'en-tête avant de la figer. Lorsque les utilisateurs ouvrent le fichier, ils voient des en-têtes de colonnes filtrables épinglés en haut – un modèle familier des applications Excel natives.

Selon la documentation Excel de Microsoft , les volets figés sont stockés dans l'élément XML sheetView de la feuille de calcul à l'intérieur du package OOXML. IronXL écrit correctement cet élément, de sorte que les fichiers produits par la bibliothèque s'ouvrent dans Excel, LibreOffice et Google Sheets sans configuration supplémentaire.

Le projet Apache POI — l'équivalent Java pour la manipulation d'Excel — utilise la même spécification OOXML sous-jacente, de sorte que le comportement du gel du volet est cohérent avec ce que les développeurs Java attendent de leurs propres outils.

Quelles sont vos prochaines étapes ?

L'implémentation de volets figés est l'un des moyens les plus efficaces d'améliorer l'expérience utilisateur de vos rapports Excel .NET . En verrouillant les en-têtes et les identifiants, vous transformez des données statiques en un outil de reporting interactif que les utilisateurs peuvent naviguer en toute confiance.

Voici un résumé du contenu de ce guide :

• Gel de ligne simple -- CreateFreezePane(0, 1) verrouille la ligne supérieure pour le défilement vertical.
• Gel simple de colonne -- CreateFreezePane(1, 0) verrouille la colonne la plus à gauche pour le défilement horizontal.
• Gel combiné -- CreateFreezePane(1, 1) verrouille à la fois la première ligne et la première colonne.
• Pré-défilement avancé -- CreateFreezePane(col, row, leftmostCol, topRow) définit une position de départ personnalisée pour le volet de défilement.
• Supprimer les volets -- RemovePane() efface toute configuration de gel ou de division existante.
• Application multi-feuilles -- Itérez sur workBook.WorkSheets pour appliquer les mêmes paramètres de gel à l'ensemble d'un classeur.

Pour continuer à développer ces compétences, consultez ces guides connexes dans la documentation IronXL :

• Charger et lire les feuilles de calcul existantes
• Créer de nouveaux classeurs et feuilles de travail
• Ajouter et supprimer des lignes et des colonnes
• Appliquer la mise en forme et les styles aux cellules
• Travailler avec des graphiques Excel
• Trier et filtrer les plages de cellules
• Appliquer une mise en forme conditionnelle
• Protéger les cahiers et les feuilles de travail

Pour une utilisation en production, achetez une licence pour débloquer toutes les fonctionnalités et déployer en toute confiance. La page de licences IronXL aborde également les options de déploiement, la redistribution sans redevance et les cas d'utilisation SaaS.

Commencez avec IronXL maintenant.

Commencer gratuitement