如何在Excel中使用C#新增命名表格 | IronXL

如何使用C#在Excel中新增命名表格

This article was translated from English: Does it need improvement?
Translated
View the article in English

要在Excel中使用C#新增命名表格,請使用AddNamedTable方法,設置表格名稱、範圍及選擇性樣式,透過單一方法呼叫實現結構化資料管理。

命名表格也常被稱為Excel表格,指的是特定型別的範圍,其經過命名並有額外的功能和屬性。 命名表格提供增強的資料組織能力、自動格式化、內建篩選及與Excel公式的無縫整合,是管理結構化資料集在Excel自動化工作流程中的必要工具。

快速入門:在一行中建立並命名表格

此範例展示如何輕鬆地在工作表中使用IronXL新增命名表格—定義名稱、範圍、篩選可見性及樣式,均在單一明確的方法呼叫中完成。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronXL.Excel

    PM > Install-Package IronXL.Excel
  2. 複製並運行這段程式碼片段。

    var table = workSheet.AddNamedTable("MyTable", workSheet.GetRange("A1:B5"), showFilter: true, tableStyle: IronXL.Styles.TableStyles.Medium2);
  3. 部署以在您的實時環境中測試

    今天就開始在您的專案中使用IronXL,透過免費試用

    arrow pointer


如何將命名表格新增至我的Excel工作表?

要新增命名表格,請使用AddNamedTable方法。 此方法需要表格名稱作為字串及範圍物件。 您也可以選擇指定表格樣式及是否顯示篩選功能。 此功能在處理DataTable導入需要妥善組織結構化資料時特別有用。

:path=/static-assets/excel/content-code-examples/how-to/named-table-2.cs
// 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(TableStyle.TableStyleDark10);
namedTable.ShowFilter = true;

// Save the modified workbook
workbook.SaveAs("modified_example.xlsx");
Imports IronXL
Imports IronXL.Styles

' Load the Excel workbook
Dim workbook = WorkBook.Load("example.xlsx")
' Select the worksheet
Dim workSheet = workbook.WorkSheets.First()

' Define the range for the named table
Dim range = workSheet("A1:B10")

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

' Optionally, set table style and visibility of the filter
namedTable.SetStyle(TableStyle.TableStyleDark10)
namedTable.ShowFilter = True

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

命名表格透過TableStyles列舉支援各種樣式選項。 您可以立即套用專業格式化,這與其他格式化功能如單元格樣式和邊框互相補充。 以下是一個範例,展示不同的表格樣式應用:

:path=/static-assets/excel/content-code-examples/how-to/named-table-3.cs
// 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: TableStyle.TableStyleLight15);

// 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: TableStyle.TableStyleDark3);

workbook.SaveAs("styled_tables.xlsx");
Imports IronXL
Imports IronXL.Styles

Dim workbook = WorkBook.Create()
Dim sheet = workbook.CreateWorkSheet("SalesData")

' Add sample data
sheet("A1").Value = "Product"
sheet("B1").Value = "Sales"
sheet("C1").Value = "Revenue"

' Populate data rows
For i As Integer = 2 To 10
    sheet($"A{i}").Value = $"Product {i - 1}"
    sheet($"B{i}").IntValue = i * 100
    sheet($"C{i}").DecimalValue = i * 250.5D
Next

' Create a light-styled table
Dim salesTable = sheet.AddNamedTable("SalesTable", sheet("A1:C10"), 
    showFilter:=True, 
    tableStyle:=TableStyle.TableStyleLight15)

' Create another table with dark styling
sheet("E1").Value = "Region"
sheet("F1").Value = "Performance"
Dim regionTable = sheet.AddNamedTable("RegionData", sheet("E1:F5"), 
    showFilter:=False, 
    tableStyle:=TableStyle.TableStyleDark3)

workbook.SaveAs("styled_tables.xlsx")
$vbLabelText   $csharpLabel
Excel工作簿顯示一個三列的命名表格和格式化的標題,包含範例文字資料

我如何從工作表中檢索命名表格?

什麼方法返回工作表中的所有命名表格?

GetNamedTableNames方法返回工作表中所有命名表格作為字串列表。 這在處理包含多個表格的工作簿或管理工作表中的動態資料結構時特別有用。

:path=/static-assets/excel/content-code-examples/how-to/named-table-4.cs
// 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);
}
Imports IronXL

' Load the Excel workbook
Dim workbook = WorkBook.Load("example.xlsx")
' Select the worksheet
Dim workSheet = workbook.WorkSheets.First()

' Retrieve all named table names
Dim tableNames = workSheet.GetNamedTableNames()

' Output each table name
For Each name In tableNames
    Console.WriteLine("Named Table: " & name)
Next
$vbLabelText   $csharpLabel

我如何根據名稱存取特定命名表格?

使用GetNamedTable方法檢索工作表中特定的命名表格。 一旦檢索到,您可以存取各種屬性並執行排序單元格範圍或應用條件格式化等操作。

:path=/static-assets/excel/content-code-examples/how-to/named-table-5.cs
// 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);
Imports IronXL

' Load the Excel workbook
Dim workbook = WorkBook.Load("example.xlsx")
' Select the worksheet
Dim workSheet = workbook.WorkSheets.First()

' Retrieve a specific named table
Dim namedTable = workSheet.GetNamedTable("MyTable")

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

處理表格資料

命名表格提供強大的資料操作能力。 以下是一個全面的範例,展示如何處理表格資料:

:path=/static-assets/excel/content-code-examples/how-to/named-table-6.cs
// 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");
Imports IronXL
Imports System.Linq

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

' Create a named table from existing data
Dim dataRange = sheet("A1:D20")
Dim salesTable = sheet.AddNamedTable("MonthlySales", dataRange, True)

' Access table data for calculations
Dim tableRange = salesTable.TableRange

' Sum values in a specific column (assuming column C contains numeric data)
Dim totalSales As Decimal = 0
For row As Integer = 2 To tableRange.RowCount
    Dim cellValue = sheet($"C{row}").DecimalValue
    totalSales += cellValue
Next

' Add summary row
Dim 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

與其他IronXL功能的整合

命名表格可以與其他IronXL功能無縫配合使用。 您可以結合公式來進行動態計算,或在建立圖表時用作資料來源。 它們在匯出到不同格式之前也是整理資料的極佳選擇。

:path=/static-assets/excel/content-code-examples/how-to/named-table-7.cs
// Example: Named table with formulas
using IronXL;
using IronXL.Styles;

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: TableStyle.TableStyleMedium9);

// 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");
Imports IronXL
Imports IronXL.Styles

Dim workbook = WorkBook.Create()
Dim 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 i As Integer = 2 To 6
    sheet($"A{i}").Value = $"Item {i - 1}"
    sheet($"B{i}").IntValue = i * 10
    sheet($"C{i}").DecimalValue = i * 15.99D
    ' Add formula to calculate total
    sheet($"D{i}").Formula = $"=B{i}*C{i}"
Next

' Create named table including the formula column
Dim priceTable = sheet.AddNamedTable("PriceCalculations", sheet("A1:D6"), 
    showFilter:=True, 
    tableStyle:=TableStyle.TableStyleMedium9)

' 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也可以新增命名範圍。 在如何新增命名範圍了解更多。

常見問題

什麼是Excel中的命名表格?

Excel中的命名表格是一種特定型別的範圍,已指定名稱並包含附加功能。IronXL允許您使用C#程式建立這些表格,提供增強的資料組織功能、自動格式化、內建篩選器以及與Excel公式的無縫整合。

如何使用C#將命名表格新增到Excel工作表中?

要使用IronXL新增命名表格,請使用AddNamedTable方法。此方法需要表格名稱作為字串以及範圍物件。您可以選擇指定表格樣式和篩選能見度。例如:workSheet.AddNamedTable("MyTable", workSheet.GetRange("A1:B5"), showFilter: true, tableStyle: IronXL.Styles.TableStyles.Medium2)。

我可以對命名表格進行自訂樣式嗎?

是的,IronXL透過TableStyles列舉支持各種命名表格的樣式選項。您可以使用Dark10、Medium2和其他預定義的表格樣式立即套用專業格式。只需使用SetStyle方法或在建立表格時指定tableStyle參數即可。

命名表格中能顯示或隱藏篩選器嗎?

當然可以!IronXL允許您控制命名表格中的篩選能見度。您可以將ShowFilter屬性設定為true或false,或直接在使用AddNamedTable方法建立表格時指定showFilter參數。

建立命名表格需要哪些必要參數?

IronXL中的AddNamedTable方法需要兩個基本參數:表格名稱(以字串形式)和定義表格區域的範圍物件。可選參數包括showFilter(布林值)和tableStyle(來自TableStyles列舉)。

我可以在同一工作表中建立多個不同樣式的命名表格嗎?

是的,IronXL允許您在同一工作表中建立具有不同樣式的多個命名表格。每個表格可以有其獨特的名稱、範圍、樣式和篩選設定,非常適合在單一Excel檔案中組織不同的資料集。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

準備好開始了嗎?
Nuget 下載 2,134,203 | 版本: 2026.7 剛剛發布
Still Scrolling Icon

仍在滾動嗎?

想要快速證明嗎? PM > Install-Package IronXL.Excel
運行一個範例 觀看您的資料成為試算表。