使用IRONXL

如何在 C# 中重命名 Excel 工作表

Name: IronXL
Brand: Iron Software
Availability: InStock
Rating: 4.67 (175 reviews)

雷根·彭

2024年四月29日

介绍

以编程方式重命名 Excel 文件是各种应用程序中的常见任务。无论是整理文件、自动执行任务还是管理数据，拥有通过代码重命名 Excel 文件的能力都会让您受益匪浅。在这篇文章中，我们将探讨如何使用IronXL库重命名 Excel 文件，该库来自Iron Software。

如何在 C# 中重命名 Excel 工作表；

创建一个 Visual Studio 项目来重命名 Excel 表单。
从Iron Software安装IronXL库。
使用 IronXL 重命名 Excel 工作表。

IronXL 库来自 Iron Software

IronXL 是由 Iron Software 开发的强大 C# Excel 库。它允许您在 .NET 项目中使用 Excel 文档，而无需 Microsoft Office 或 Excel Interop。

IronXL的主要功能

读取、编辑和创建 Excel 文件：IronXL 使您能够直接从 C# 或 VB.NET 代码读取、生成和编辑 Excel 电子表格文件（包括 XLSX、XLS、XLSM、XLTX、CSV 和 TSV 格式）。
无需Office互操作：您无需安装Microsoft Office或处理Office互操作的复杂性。IronXL提供了一种无忧的体验。
跨平台支持：IronXL 旨在为 .NET 8、7、6、Core、Framework 和 Azure 提供支持。无论您是在构建控制台应用程序、网络应用程序还是桌面软件，IronXL 都能满足您的需求。
1. 用户友好的 API：直观的 API 使您能够执行读取单元格值、计算汇总值、处理公式、创建图表等任务。让我们简要地看一个例子：

using IronXL;
    namespace RenameExcelSheets;
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("Rename Excel Sheets Using IronXL");
            // Load an existing Excel file to excel workbook object
            WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
            // Select specified worksheet
            WorkSheet workSheet = workBook.WorkSheets [0];
            // Read a cell value from same workbook
            int cellValue = workSheet ["A2"].IntValue;
            // Iterate through a range of cells
            foreach (var cell in workSheet ["A2:A10"])
            {
                Console.WriteLine($"Cell {cell.AddressString} has value     '{cell.Text}'");
            }
            // Calculate aggregate values
            decimal sum = workSheet ["A2:A10"].Sum();
            decimal max = workSheet ["A2:A10"].Max(c => c.DecimalValue);
            workBook.SaveAs("sampleResult.xlsx"); // save as new workbook
        }
    }

using IronXL;
    namespace RenameExcelSheets;
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("Rename Excel Sheets Using IronXL");
            // Load an existing Excel file to excel workbook object
            WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
            // Select specified worksheet
            WorkSheet workSheet = workBook.WorkSheets [0];
            // Read a cell value from same workbook
            int cellValue = workSheet ["A2"].IntValue;
            // Iterate through a range of cells
            foreach (var cell in workSheet ["A2:A10"])
            {
                Console.WriteLine($"Cell {cell.AddressString} has value     '{cell.Text}'");
            }
            // Calculate aggregate values
            decimal sum = workSheet ["A2:A10"].Sum();
            decimal max = workSheet ["A2:A10"].Max(c => c.DecimalValue);
            workBook.SaveAs("sampleResult.xlsx"); // save as new workbook
        }
    }

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

无需麻烦的Excel功能：IronXL使您能够轻松创建、加载、保存和操作电子表格。无论是处理元数据、权限、公式还是样式，IronXL 都能简化过程。
请记住，IronXL 因其准确性、易用性和快速性而受到全球数百万工程师的信赖。如果您使用 C# 或 VB.NET 处理 Excel 文件，IronXL 是您的首选库！

设置环境

在开始编码之前，请确保您已经安装了必要的工具：

Visual Studio：安装 Visual Studio 或其他首选的 C# IDE。
Microsoft Excel：确保您的系统上已安装 Microsoft Excel。
为了演示重命名 Excel 文件的实际例子，让我们编写一个程序，获取包含所有要重命名文件的文件夹，并使用 IronXL 对所有文件进行重命名，然后将它们存储到输出文件夹中。

第 1 步：创建 Visual Studio 项目，重命名 Excel 表单。

打开 Visual Studio，为演示创建一个新项目。从以下模板中选择控制台应用程序。

如何在 C# 中重命名 Excel 工作表：图 1 - 创建一个控制台应用程序

提供项目名称和文件存储路径。

如何在C#中重命名Excel工作表：图2 - 为项目命名

选择所需的 .NET 版本。

如何在C#中重命名Excel工作表：图3 - 选择所需的.NET版本

步骤2：从Iron Software安装IronXL库。

IronXL 库可以按以下方式从 Visual Studio 包管理器中安装。

如何在 C# 中重命名 Excel 工作表：图 4 - 使用 NuGet 包管理器搜索 IronXL

或可使用命令从 NuGet 软件包管理器中安装。

dotnet add package IronXL.Excel --version 2024.4.4

dotnet add package IronXL.Excel --version 2024.4.4

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'dotnet add package IronXL.Excel --version 2024.4.4

$vbLabelText $csharpLabel

如何在 C# 中重命名 Excel 工作表：图 5 - IronXL 主页

安装完成后，该项目就可以开始编码，对 Excel 工作表进行重命名。

步骤 3：使用IronXL重命名 Excel 工作表

以下是重命名商业应用程序目录中所有文件和工作表的程序。

输入：

！如何在 C# 中重命名 Excel 工作表：图 6 - 重命名的 Excel 工作表输入示例

using IronXL;
namespace RenameExcelSheets;
public class Program
{
    public static void Main()
    {
        Console.WriteLine("Demo Rename Excel Sheets Using IronXL");
        Console.WriteLine("Enter Folder where Excel Files are present to rename to FinancialReport2024");
        var folderPath = Console.ReadLine();
        if (string.IsNullOrEmpty(folderPath)) // check for empty string
        {
            throw new AggregateException("Path is empty");
        }
        if (Directory.Exists(folderPath) == false)
        {
            throw new AggregateException("Path is Wrong");
        }
        var files = Directory.GetFiles(folderPath);
        var outputPath = Path.Combine(folderPath, "output");
        var index = 0;
        foreach (var file in files)
        {
            // Load an existing Excel file
            WorkBook workBook = WorkBook.Load(file);
            // Select the first worksheet (index 0)
            WorkSheet workSheet = workBook.WorkSheets [0];
            // Rename the worksheet
            workSheet.Name = "FinancialReport2024"; // change the name property
            // Save the modified workbook
            workBook.SaveAs(Path.Join(outputPath, $"FinancialReport2024_{index++}.xlsx"));
        }
    }
}

using IronXL;
namespace RenameExcelSheets;
public class Program
{
    public static void Main()
    {
        Console.WriteLine("Demo Rename Excel Sheets Using IronXL");
        Console.WriteLine("Enter Folder where Excel Files are present to rename to FinancialReport2024");
        var folderPath = Console.ReadLine();
        if (string.IsNullOrEmpty(folderPath)) // check for empty string
        {
            throw new AggregateException("Path is empty");
        }
        if (Directory.Exists(folderPath) == false)
        {
            throw new AggregateException("Path is Wrong");
        }
        var files = Directory.GetFiles(folderPath);
        var outputPath = Path.Combine(folderPath, "output");
        var index = 0;
        foreach (var file in files)
        {
            // Load an existing Excel file
            WorkBook workBook = WorkBook.Load(file);
            // Select the first worksheet (index 0)
            WorkSheet workSheet = workBook.WorkSheets [0];
            // Rename the worksheet
            workSheet.Name = "FinancialReport2024"; // change the name property
            // Save the modified workbook
            workBook.SaveAs(Path.Join(outputPath, $"FinancialReport2024_{index++}.xlsx"));
        }
    }
}

Imports IronXL
Namespace RenameExcelSheets
	Public Class Program
		Public Shared Sub Main()
			Console.WriteLine("Demo Rename Excel Sheets Using IronXL")
			Console.WriteLine("Enter Folder where Excel Files are present to rename to FinancialReport2024")
			Dim folderPath = Console.ReadLine()
			If String.IsNullOrEmpty(folderPath) Then ' check for empty string
				Throw New AggregateException("Path is empty")
			End If
			If Directory.Exists(folderPath) = False Then
				Throw New AggregateException("Path is Wrong")
			End If
			Dim files = Directory.GetFiles(folderPath)
			Dim outputPath = Path.Combine(folderPath, "output")
			Dim index = 0
			For Each file In files
				' Load an existing Excel file
				Dim workBook As WorkBook = WorkBook.Load(file)
				' Select the first worksheet (index 0)
				Dim workSheet As WorkSheet = workBook.WorkSheets (0)
				' Rename the worksheet
				workSheet.Name = "FinancialReport2024" ' change the name property
				' Save the modified workbook
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: workBook.SaveAs(Path.Join(outputPath, string.Format("FinancialReport2024_{0}.xlsx", index++)));
				workBook.SaveAs(Path.Join(outputPath, $"FinancialReport2024_{index}.xlsx"))
				index += 1
			Next file
		End Sub
	End Class
End Namespace

$vbLabelText $csharpLabel

代码解释

以文件夹路径重命名所有文件及其工作表
检查文件夹路径是否为空字符串
检查文件夹路径是否有效
获取扩展名为 xlsx 的文件夹中的所有文件
遍历文件并从 IronXL 加载到 WorkBook 对象，重命名工作表名称属性。
将文件保存到输出文件夹
输出
在下面的输出中，您可以看到所有 3 个文件都已重命名，其中的 Excel 表也重命名为 FinancialReport2024。

以编程方式重命名 Excel 表单的优势包括

效率：自动化减少了与手动重命名相关的人工努力和人为错误，节省了时间和资源。
一致性：自动重命名可确保跨工作表的统一性和对命名约定的遵守，从而提高数据组织和可读性。
可扩展性：通过编程重命名工作表可以批量重命名并提高可扩展性，使其适合处理大型数据集或重复任务。
集成：与现有工作流程或应用程序的集成能够实现无缝的数据处理并增强整体生产力。
自定义：自动化提供了灵活性，可以根据特定的业务需求或标准自定义重命名逻辑。

许可

IronXL 是一个企业级库，与许可协议配合使用。有关许可的更多信息可以在这里找到。许可证密钥需要放在此处的 appsettings.json 文件中。

{
  "IronXL.License.LicenseKey" : "IRONXL-MYLICENSE-KEY-1EF01"
}

{
  "IronXL.License.LicenseKey" : "IRONXL-MYLICENSE-KEY-1EF01"
}

If True Then
  "IronXL.License.LicenseKey" : "IRONXL-MYLICENSE-KEY-1EF01"
End If

$vbLabelText $csharpLabel

结论

使用 C# 重命名 Excel 文件是一个简单明了的过程。通过利用IronXL库来自Iron Software，您可以在 C# 应用程序中轻松重命名 Excel 文件。该库是开发人员进行所有 Excel 表操作（无论是读取、写入还是管理）的便捷工具。

现在，您已经学会了如何以编程方式重命名 Excel 文件，您可以将此功能纳入 C# 项目，以简化文件管理任务并提高自动化能力。

雷根·彭

立即与工程团队聊天

软件工程师

Regan毕业于雷丁大学，拥有电子工程学士学位。在加入Iron Software之前，他的前工作职位要求他专注于单一任务；他在Iron Software最喜欢的是能进行多种工作，无论是增加销售价值、技术支持、产品开发还是营销。他喜欢了解开发人员如何使用Iron Software的库，并利用这些知识不断改进文档和开发产品。

< 前一页
如何使用 C# Excel 字体样式

下一步 >
如何在C#控制台应用程序中读取Excel文件