1. IronXL
  2. Guides pratiques
  3. Table nommée
Comment ajouter une table nommée dans Excel en utilisant C# | IronXL

Comment ajouter un tableau nommé dans Excel en utilisant C#

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Pour ajouter un tableau nommé dans Excel à l'aide de C#, utilisez la méthode AddNamedTable d'IronXL avec des paramètres pour le nom du tableau, la plage et le style facultatif - ce qui permet une gestion structurée des données avec un seul appel de méthode.

Un tableau nommé est également communément appelé tableau Excel ; il s'agit d'un type spécifique de plage de cellules qui a été désignée par un nom et qui possède des fonctionnalités et des propriétés supplémentaires. Les tableaux nommés offrent des capacités d'organisation des données améliorées, un formatage automatique, un filtrage intégré et une intégration transparente avec les formules Excel, ce qui les rend essentiels pour la gestion des ensembles de données structurés dans les flux de travail d'automatisation d'Excel.

Démarrage rapide : Créer et nommer un tableau en une seule ligne

Cet exemple montre avec quelle facilité vous pouvez ajouter un tableau nommé à votre feuille de calcul à l'aide d'IronXL : définissez le nom, la plage, la visibilité du filtre et le style en un seul appel de méthode clair.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronXL avec le gestionnaire de packages NuGet

    PM > Install-Package IronXL.Excel

  2. Copiez et exécutez cet extrait de code.

    var table = workSheet.AddNamedTable("MyTable", workSheet.GetRange("A1:B5"), showFilter: true, tableStyle: IronXL.Styles.TableStyles.Medium2);

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronXL dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour ajouter des tables nommées
  2. Sélectionnez la plage cible avec feuille de travail["A1:A5"]
  3. Utilisez la méthode AddNamedTable pour ajouter des tables nommées
  4. Récupérer les tables nommées de différentes manières
  5. Exportez le fichier Excel modifié dans divers formats


Comment ajouter un tableau nommé à ma feuille de calcul Excel?

Pour ajouter une table nommée, utilisez la méthode AddNamedTable . La méthode requiert le nom de la table sous forme de chaîne de caractères et l'objet plage. Vous avez également la possibilité de spécifier le style du tableau et d'afficher ou non le filtre. Cette fonctionnalité est particulièrement utile pour travailler avec DataSet et DataTable lorsque des données structurées doivent être organisées de manière appropriée.

// Example code to add a named table using IronXL
using IronXL;
using IronXL.Styles;

// Load the Excel workbook
var workbook = WorkBook.Load("example.xlsx");
// Select the worksheet
var workSheet = workbook.WorkSheets.First();

// Define the range for the named table
var range = workSheet["A1:B10"];

// Add a named table with the specified name and range
var namedTable = workSheet.AddNamedTable("MyTable", range);

// Optionally, set table style and visibility of the filter
namedTable.SetStyle(TableStyles.Dark10);
namedTable.ShowFilter = true;

// Save the modified workbook
workbook.SaveAs("modified_example.xlsx");
// Example code to add a named table using IronXL
using IronXL;
using IronXL.Styles;

// Load the Excel workbook
var workbook = WorkBook.Load("example.xlsx");
// Select the worksheet
var workSheet = workbook.WorkSheets.First();

// Define the range for the named table
var range = workSheet["A1:B10"];

// Add a named table with the specified name and range
var namedTable = workSheet.AddNamedTable("MyTable", range);

// Optionally, set table style and visibility of the filter
namedTable.SetStyle(TableStyles.Dark10);
namedTable.ShowFilter = true;

// Save the modified workbook
workbook.SaveAs("modified_example.xlsx");
$vbLabelText   $csharpLabel

Les tableaux nommés prennent en charge diverses options de style grâce à l'énumération TableStyles. Vous pouvez appliquer une mise en forme professionnelle instantanément, ce qui complète d'autres fonctionnalités de mise en forme comme le style de cellule et les bordures. Voici un exemple illustrant différentes applications de style tableau :

// Example: Creating multiple styled named tables
using IronXL;
using IronXL.Styles;

var workbook = WorkBook.Create();
var sheet = workbook.CreateWorkSheet("SalesData");

// Add sample data
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Sales";
sheet["C1"].Value = "Revenue";

// Populate data rows
for (int i = 2; i <= 10; i++)
{
    sheet[$"A{i}"].Value = $"Product {i-1}";
    sheet[$"B{i}"].IntValue = i * 100;
    sheet[$"C{i}"].DecimalValue = i * 250.50m;
}

// Create a light-styled table
var salesTable = sheet.AddNamedTable("SalesTable", sheet["A1:C10"], 
    showFilter: true, 
    tableStyle: TableStyles.Light15);

// Create another table with dark styling
sheet["E1"].Value = "Region";
sheet["F1"].Value = "Performance";
var regionTable = sheet.AddNamedTable("RegionData", sheet["E1:F5"], 
    showFilter: false, 
    tableStyle: TableStyles.Dark3);

workbook.SaveAs("styled_tables.xlsx");
// Example: Creating multiple styled named tables
using IronXL;
using IronXL.Styles;

var workbook = WorkBook.Create();
var sheet = workbook.CreateWorkSheet("SalesData");

// Add sample data
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Sales";
sheet["C1"].Value = "Revenue";

// Populate data rows
for (int i = 2; i <= 10; i++)
{
    sheet[$"A{i}"].Value = $"Product {i-1}";
    sheet[$"B{i}"].IntValue = i * 100;
    sheet[$"C{i}"].DecimalValue = i * 250.50m;
}

// Create a light-styled table
var salesTable = sheet.AddNamedTable("SalesTable", sheet["A1:C10"], 
    showFilter: true, 
    tableStyle: TableStyles.Light15);

// Create another table with dark styling
sheet["E1"].Value = "Region";
sheet["F1"].Value = "Performance";
var regionTable = sheet.AddNamedTable("RegionData", sheet["E1:F5"], 
    showFilter: false, 
    tableStyle: TableStyles.Dark3);

workbook.SaveAs("styled_tables.xlsx");
$vbLabelText   $csharpLabel
Feuille de calcul Excel montrant un tableau nommé avec trois colonnes et des en-têtes formatés contenant un échantillon de données textuelles

Comment récupérer des tableaux nommés dans ma feuille de calcul?

Quelle est la méthode qui renvoie tous les tableaux nommés d'une feuille de calcul ?

La méthode GetNamedTableNames renvoie toutes les tables nommées dans la feuille de calcul sous la forme d'une liste de chaînes. Ces outils sont particulièrement utiles pour travailler avec des classeurs contenant plusieurs tableaux ou pour gérer des feuilles de calcul avec des structures de données dynamiques.

// Example code to retrieve all named table names using IronXL
using IronXL;

// Load the Excel workbook
var workbook = WorkBook.Load("example.xlsx");
// Select the worksheet
var workSheet = workbook.WorkSheets.First();

// Retrieve all named table names
var tableNames = workSheet.GetNamedTableNames();

// Output each table name
foreach (var name in tableNames)
{
    Console.WriteLine("Named Table: " + name);
}
// Example code to retrieve all named table names using IronXL
using IronXL;

// Load the Excel workbook
var workbook = WorkBook.Load("example.xlsx");
// Select the worksheet
var workSheet = workbook.WorkSheets.First();

// Retrieve all named table names
var tableNames = workSheet.GetNamedTableNames();

// Output each table name
foreach (var name in tableNames)
{
    Console.WriteLine("Named Table: " + name);
}
$vbLabelText   $csharpLabel

Comment accéder à une table spécifique par son nom?

Utilisez la méthode GetNamedTable pour récupérer un tableau nommé spécifique dans la feuille de calcul. Une fois récupéré, vous pouvez accéder à diverses propriétés et effectuer des opérations telles que trier des plages de cellules ou appliquer un formatage conditionnel.

// Example code to retrieve a specific named table using IronXL
using IronXL;

// Load the Excel workbook
var workbook = WorkBook.Load("example.xlsx");
// Select the worksheet
var workSheet = workbook.WorkSheets.First();

// Retrieve a specific named table
var namedTable = workSheet.GetNamedTable("MyTable");

// Output some information about the table
Console.WriteLine("Named Table: " + namedTable.Name);
Console.WriteLine("Rows: " + namedTable.Rows);
// Example code to retrieve a specific named table using IronXL
using IronXL;

// Load the Excel workbook
var workbook = WorkBook.Load("example.xlsx");
// Select the worksheet
var workSheet = workbook.WorkSheets.First();

// Retrieve a specific named table
var namedTable = workSheet.GetNamedTable("MyTable");

// Output some information about the table
Console.WriteLine("Named Table: " + namedTable.Name);
Console.WriteLine("Rows: " + namedTable.Rows);
$vbLabelText   $csharpLabel

Travailler avec des données de tableau

Les tableaux nommés offrent de puissantes possibilités de manipulation des données. Voici un exemple complet montrant comment travailler avec des données de tableau :

// Advanced named table operations
using IronXL;
using System.Linq;

var workbook = WorkBook.Load("sales_data.xlsx");
var sheet = workbook.DefaultWorkSheet;

// Create a named table from existing data
var dataRange = sheet["A1:D20"];
var salesTable = sheet.AddNamedTable("MonthlySales", dataRange, true);

// Access table data for calculations
var tableRange = salesTable.TableRange;

// Sum values in a specific column (assuming column C contains numeric data)
decimal totalSales = 0;
for (int row = 2; row <= tableRange.RowCount; row++)
{
    var cellValue = sheet[$"C{row}"].DecimalValue;
    totalSales += cellValue;
}

// Add summary row
var summaryRow = tableRange.RowCount + 1;
sheet[$"B{summaryRow}"].Value = "Total:";
sheet[$"C{summaryRow}"].Value = totalSales;

// Apply formatting to the summary row
sheet[$"B{summaryRow}:D{summaryRow}"].Style.Font.Bold = true;
sheet[$"B{summaryRow}:D{summaryRow}"].Style.SetBackgroundColor("#FFE599");

workbook.SaveAs("sales_with_summary.xlsx");
// Advanced named table operations
using IronXL;
using System.Linq;

var workbook = WorkBook.Load("sales_data.xlsx");
var sheet = workbook.DefaultWorkSheet;

// Create a named table from existing data
var dataRange = sheet["A1:D20"];
var salesTable = sheet.AddNamedTable("MonthlySales", dataRange, true);

// Access table data for calculations
var tableRange = salesTable.TableRange;

// Sum values in a specific column (assuming column C contains numeric data)
decimal totalSales = 0;
for (int row = 2; row <= tableRange.RowCount; row++)
{
    var cellValue = sheet[$"C{row}"].DecimalValue;
    totalSales += cellValue;
}

// Add summary row
var summaryRow = tableRange.RowCount + 1;
sheet[$"B{summaryRow}"].Value = "Total:";
sheet[$"C{summaryRow}"].Value = totalSales;

// Apply formatting to the summary row
sheet[$"B{summaryRow}:D{summaryRow}"].Style.Font.Bold = true;
sheet[$"B{summaryRow}:D{summaryRow}"].Style.SetBackgroundColor("#FFE599");

workbook.SaveAs("sales_with_summary.xlsx");
$vbLabelText   $csharpLabel

Intégration avec d'autres fonctionnalités d'IronXL

Les tableaux nommés fonctionnent de manière transparente avec d'autres fonctionnalités d'IronXL. Vous pouvez les combiner avec formules pour des calculs dynamiques ou les utiliser comme sources de données lorsque vous créez des graphiques. Ils sont également excellents pour organiser les données avant de les exporter vers différents formats.

// Example: Named table with formulas
using IronXL;

var workbook = WorkBook.Create();
var sheet = workbook.CreateWorkSheet("Analysis");

// Create data structure
sheet["A1"].Value = "Item";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Price";
sheet["D1"].Value = "Total";

// Add sample data
for (int i = 2; i <= 6; i++)
{
    sheet[$"A{i}"].Value = $"Item {i-1}";
    sheet[$"B{i}"].IntValue = i * 10;
    sheet[$"C{i}"].DecimalValue = i * 15.99m;
    // Add formula to calculate total
    sheet[$"D{i}"].Formula = $"=B{i}*C{i}";
}

// Create named table including the formula column
var priceTable = sheet.AddNamedTable("PriceCalculations", sheet["A1:D6"], 
    showFilter: true, 
    tableStyle: TableStyles.Medium9);

// Add a grand total formula
sheet["C7"].Value = "Grand Total:";
sheet["D7"].Formula = "=SUM(D2:D6)";
sheet["D7"].Style.Font.Bold = true;

workbook.SaveAs("table_with_formulas.xlsx");
// Example: Named table with formulas
using IronXL;

var workbook = WorkBook.Create();
var sheet = workbook.CreateWorkSheet("Analysis");

// Create data structure
sheet["A1"].Value = "Item";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Price";
sheet["D1"].Value = "Total";

// Add sample data
for (int i = 2; i <= 6; i++)
{
    sheet[$"A{i}"].Value = $"Item {i-1}";
    sheet[$"B{i}"].IntValue = i * 10;
    sheet[$"C{i}"].DecimalValue = i * 15.99m;
    // Add formula to calculate total
    sheet[$"D{i}"].Formula = $"=B{i}*C{i}";
}

// Create named table including the formula column
var priceTable = sheet.AddNamedTable("PriceCalculations", sheet["A1:D6"], 
    showFilter: true, 
    tableStyle: TableStyles.Medium9);

// Add a grand total formula
sheet["C7"].Value = "Grand Total:";
sheet["D7"].Formula = "=SUM(D2:D6)";
sheet["D7"].Style.Font.Bold = true;

workbook.SaveAs("table_with_formulas.xlsx");
$vbLabelText   $csharpLabel

IronXL peut également ajouter des plages nommées. Pour en savoir plus, consultez la section " Comment ajouter une plage nommée " .

Questions Fréquemment Posées

Qu'est-ce qu'un tableau nommé dans Excel ?

Un tableau nommé dans Excel est un type spécifique de plage qui a été désigné par un nom et qui comprend des fonctionnalités supplémentaires. IronXL vous permet de créer ces tableaux de manière programmatique en C#, en offrant des capacités d'organisation des données améliorées, un formatage automatique, un filtrage intégré et une intégration transparente avec les formules Excel.

Comment ajouter un tableau nommé à une feuille de calcul Excel à l'aide de C# ?

Pour ajouter une table nommée à l'aide d'IronXL, utilisez la méthode AddNamedTable. Cette méthode requiert le nom de la table sous forme de chaîne et un objet de plage. Vous pouvez éventuellement spécifier le style du tableau et la visibilité du filtre. Par exemple : workSheet.AddNamedTable("MyTable", workSheet.GetRange("A1:B5"), showFilter : true, tableStyle : IronXL.Styles.TableStyles.Medium2).

Puis-je appliquer un style personnalisé aux tableaux nommés ?

Oui, IronXL prend en charge diverses options de style pour les tables nommées grâce à l'énumération TableStyles. Vous pouvez appliquer un formatage professionnel instantanément en utilisant des styles tels que Dark10, Medium2, et d'autres styles de tableau prédéfinis. Il suffit d'utiliser la méthode SetStyle ou de spécifier le paramètre tableStyle lors de la création du tableau.

Est-il possible d'afficher ou de masquer les filtres dans les tables nommées ?

Absolument ! IronXL vous permet de contrôler la visibilité des filtres dans les tables nommées. Vous pouvez définir la propriété ShowFilter à true ou false, ou la spécifier directement lors de la création de la table en utilisant le paramètre showFilter dans la méthode AddNamedTable.

Quels sont les paramètres requis pour créer une table nommée ?

La méthode AddNamedTable d'IronXL requiert deux paramètres essentiels : le nom de la table (sous forme de chaîne) et l'objet range définissant la zone de la table. Les paramètres facultatifs sont showFilter (booléen) et tableStyle (de l'énumération TableStyles).

Puis-je créer plusieurs tables nommées stylisées dans la même feuille de calcul ?

Oui, IronXL vous permet de créer plusieurs tableaux nommés avec des styles différents dans la même feuille de calcul. Chaque tableau peut avoir son propre nom, sa propre plage, son propre style et ses propres paramètres de filtrage, ce qui le rend parfait pour organiser différents ensembles de données dans un seul fichier Excel.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

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 ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 1,802,965 | Version : 2025.12 vient de sortir