使用IRONXL

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

發佈 2024年4月29日
分享:

介紹

以程式方式重新命名 Excel 檔案是各種應用程式中常見的任務。 無論您是組織文件、自動化任務還是管理數據,通過程式碼重命名 Excel 文件都能帶來極大的好處。 在本文中,我們將探討如何使用 來重新命名 Excel 檔案。IronXL圖書館由Iron Software.

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

  1. 建立一個 Visual Studio 專案來重命名 Excel 工作表。

  2. 安裝IronXL圖書館由Iron Software.

  3. 使用重命名 Excel 工作表IronXL.

IronXL 庫來自 Iron Software

IronXL是一款由開發的強大C# Excel庫Iron Software. 它允許您在 .NET 專案中使用 Excel 文件,而不需要 Microsoft Office 或 Excel Interop。

IronXL 的主要功能

  1. 讀取、編輯和創建 Excel 文件:IronXL 讓您能夠讀取、生成和編輯 Excel 試算表文件。(包括 XLSX、XLS、XLSM、XLTX、CSV 和 TSV 格式)直接從您的 C# 或 VB.NET 代碼中。

  2. 不需要 Office Interop:您不需要安裝 Microsoft Office 或處理 Office Interop 的複雜性。IronXL 提供無憂的使用體驗。

  3. 跨平台支持: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
VB   C#
  1. Excel 功能無煩惱:IronXL 讓您可以輕鬆創建、加載、保存和操作電子表格。 無論您是在處理元數據、權限、公式或是樣式設計,IronXL 都能簡化這個過程。

    請記住,IronXL 因其準確性、易用性和速度而受到全球數百萬工程師的信賴。 如果您正在使用 C# 或 VB.NET 處理 Excel 文件,IronXL 是您的首選庫。!

設定環境

在進入編程部分之前,請確保您已安裝必要的工具:

  1. Visual Studio:安裝 Visual Studio 或任何其他偏好的 C# IDE。

  2. 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 套件管理器安裝該 library,如下所示。

如何在 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
VB   C#

如何在 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
VB   C#

程式碼說明

  1. 取得資料夾路徑以重新命名所有文件及其工作表。

  2. 檢查資料夾路徑是否為空字串

  3. 檢查資料夾路徑是否有效

  4. 獲取文件夾中所有具有 xlsx 擴展名的文件

  5. 遍歷檔案,並從IronXL載入至WorkBook物件以重新命名工作表名稱屬性。

  6. 將檔案儲存到輸出資料夾。

    輸出

    在以下輸出中,您可以看到所有三個文件都被重新命名,其中的 Excel 表也被重新命名為 FinancialReport2024。

    如何在 C# 中重新命名 Excel 工作表:圖 7 - 使用 IronXL 將所有 Excel 工作表重新命名的示例輸出

以程式方式重新命名 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
VB   C#

結論

使用 C# 重新命名 Excel 文件是個簡單的過程。 通過利用IronXL圖書館由Iron Software,您可以輕鬆地在 C# 應用程式中重新命名 Excel 文件。 這個函式庫是開發人員處理所有 Excel 工作表操作的便捷工具,不論是讀取、寫入或管理。

現在,您已經學會了如何以程式化方式重命名 Excel 文件,您可以將此功能整合到您的 C# 專案中,以簡化文件管理任務並提升自動化能力。

< 上一頁
如何使用 C# 設置 Excel 字體樣式
下一個 >
如何在C#控制台應用程式中讀取Excel檔案

準備開始了嗎? 版本: 2024.11 剛剛發布

免費 NuGet 下載 總下載次數: 1,086,940 查看許可證 >