엑셀 파일을 프로그래밍적으로 이름 변경하는 것은 다양한 응용 프로그램에서 흔한 작업입니다. 파일을 정리하거나 작업을 자동화하거나 데이터를 관리하든 간에 코드로 엑셀 파일의 이름을 변경할 수 있으면 매우 유용합니다. 이 기사에서는 IronXL 라이브러리를 사용하여 엑셀 파일의 이름을 변경하는 방법을 알아보겠습니다.

How to Rename Excel WorkSheet in C#

1. 엑셀 시트를 이름 변경하기 위한 Visual Studio 프로젝트를 만듭니다.
2. IronXL 라이브러리를 Iron Software에서 설치합니다.
3. IronXL을 사용하여 엑셀 시트의 이름을 변경합니다.

IronXL 라이브러리 from Iron Software

IronXL은 Iron Software가 개발한 강력한 C# 엑셀 라이브러리입니다. 마이크로소프트 오피스 또는 엑셀 Interop 없이 .NET 프로젝트에서 엑셀 문서와 작업할 수 있습니다.

IronXL 의 주요 특징

1. 엑셀 파일 읽기, 수정 및 생성: IronXL은 C# 또는 VB.NET 코드에서 엑셀 스프레드시트 파일(XLSX, XLS, XLSM, XLTX, CSV 및 TSV 형식 포함)을 직접 읽고 생성 및 수정할 수 있게 해줍니다.

2. 오피스 Interop 불필요: 마이크로소프트 오피스를 설치하거나 오피스 Interop의 복잡성을 다룰 필요가 없습니다. IronXL은 간편한 경험을 제공합니다.

3. 크로스 플랫폼 지원: IronXL은 .NET 8, 7, 6, Core, Framework 및 Azure를 위해 설계되었습니다. 콘솔 응용 프로그램, 웹 앱 또는 데스크톱 소프트웨어를 빌드 중이든 IronXL이 지원합니다.

4. 사용자 친화적인 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 into a WorkBook object
               WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
               
               // Select the specified worksheet (first sheet)
               WorkSheet workSheet = workBook.WorkSheets[0];
               
               // Read a cell value from the workbook
               int cellValue = workSheet["A2"].IntValue;
               
               // Iterate through a range of cells and print their values
               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);
               
               // Save as a new workbook
               workBook.SaveAs("sampleResult.xlsx");
           }
       }
   }

   C#

5. 수고 없이 엑셀 기능 제공: IronXL을 사용하면 스프레드시트를 쉽게 생성, 로드, 저장 및 조작할 수 있습니다. 메타데이터, 권한, 수식 또는 스타일링을 다루든 IronXL은 프로세스를 단순화합니다.

전 세계 수백만 명의 엔지니어들이 IronXL을 정확성, 사용 편의성 및 속도로 신뢰하고 있습니다. C# 또는 VB.NET에서 엑셀 파일을 작업 중이라면 IronXL이 적합한 라이브러리입니다!

환경 설정

코딩 부분을 시작하기 전에 필요한 도구가 설치되어 있는지 확인하십시오:

1. Visual Studio: Visual Studio 또는 다른 선호하는 C# IDE를 설치하십시오.
2. Microsoft Excel: 시스템에 Microsoft Excel이 설치되어 있는지 확인하세요.

Excel 파일 이름 바꾸기의 실제 예를 보여주기 위해 IronXL을 사용하여 모든 파일의 이름을 바꾸고, 출력 폴더에 저장하는 프로그램을 작성해 보겠습니다.

1단계: Excel 시트 이름 변경을 위한 Visual Studio 프로젝트 생성

Visual Studio를 열고 데모를 위한 새 프로젝트를 만드세요. 아래 템플릿에서 콘솔 앱을 선택하세요.

프로젝트 이름과 파일을 저장할 경로를 지정하세요.

필요한 .NET 버전을 선택하세요.

2단계: IronXL 라이브러리를 Iron Software에서 설치합니다.

IronXL 라이브러리는 Visual Studio 패키지 관리자에서 아래와 같이 설치할 수 있습니다.

명령어로 NuGet 패키지 관리자에서 설치할 수도 있습니다.

dotnet add package IronXL.Excel --version 2024.4.4

설치가 완료되면 프로젝트는 Excel 워크시트를 변경하는 코딩을 시작할 준비가 됩니다.

3단계: IronXL을 사용하여 Excel 시트의 이름 변경

아래는 비즈니스 애플리케이션에 사용되는 디렉토리의 모든 파일과 워크시트의 이름을 바꾸기 위한 프로그램입니다.

입력:

using System;
using System.IO;
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");
            
            // Getting input folder path from user
            var folderPath = Console.ReadLine();

            // Check if the provided path is not empty
            if (string.IsNullOrEmpty(folderPath))
            {
                throw new ArgumentException("Path is empty");
            }

            // Check if the given folder path exists
            if (!Directory.Exists(folderPath))
            {
                throw new ArgumentException("Path is Wrong");
            }

            // Get all files in the directory
            var files = Directory.GetFiles(folderPath);
            
            // Define output directory for renamed files
            var outputPath = Path.Combine(folderPath, "output");
            Directory.CreateDirectory(outputPath); // Ensures the output directory exists

            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 with a new name in the output folder
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index++}.xlsx"));
            }
        }
    }
}

using System;
using System.IO;
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");
            
            // Getting input folder path from user
            var folderPath = Console.ReadLine();

            // Check if the provided path is not empty
            if (string.IsNullOrEmpty(folderPath))
            {
                throw new ArgumentException("Path is empty");
            }

            // Check if the given folder path exists
            if (!Directory.Exists(folderPath))
            {
                throw new ArgumentException("Path is Wrong");
            }

            // Get all files in the directory
            var files = Directory.GetFiles(folderPath);
            
            // Define output directory for renamed files
            var outputPath = Path.Combine(folderPath, "output");
            Directory.CreateDirectory(outputPath); // Ensures the output directory exists

            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 with a new name in the output folder
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index++}.xlsx"));
            }
        }
    }
}

Imports System
Imports System.IO
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")

            ' Getting input folder path from user
            Dim folderPath = Console.ReadLine()

            ' Check if the provided path is not empty
            If String.IsNullOrEmpty(folderPath) Then
                Throw New ArgumentException("Path is empty")
            End If

            ' Check if the given folder path exists
            If Not Directory.Exists(folderPath) Then
                Throw New ArgumentException("Path is Wrong")
            End If

            ' Get all files in the directory
            Dim files = Directory.GetFiles(folderPath)

            ' Define output directory for renamed files
            Dim outputPath = Path.Combine(folderPath, "output")
            Directory.CreateDirectory(outputPath) ' Ensures the output directory exists

            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 with a new name in the output folder
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index}.xlsx"))
                index += 1
            Next
        End Sub
    End Class
End Namespace

Imports System
Imports System.IO
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")

            ' Getting input folder path from user
            Dim folderPath = Console.ReadLine()

            ' Check if the provided path is not empty
            If String.IsNullOrEmpty(folderPath) Then
                Throw New ArgumentException("Path is empty")
            End If

            ' Check if the given folder path exists
            If Not Directory.Exists(folderPath) Then
                Throw New ArgumentException("Path is Wrong")
            End If

            ' Get all files in the directory
            Dim files = Directory.GetFiles(folderPath)

            ' Define output directory for renamed files
            Dim outputPath = Path.Combine(folderPath, "output")
            Directory.CreateDirectory(outputPath) ' Ensures the output directory exists

            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 with a new name in the output folder
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index}.xlsx"))
                index += 1
            Next
        End Sub
    End Class
End Namespace

코드 설명

1. 프로그램은 사용자가 Excel 파일이 있는 폴더 경로를 입력하도록 요청합니다.
2. 폴더 경로가 빈 문자열인지, 폴더가 실제로 존재하는지 확인합니다.
3. 지정된 폴더에서 모든 파일을 검색합니다.
4. 이러한 파일을 반복하며 IronXL 라이브러리의 WorkBook 객체로 각각을 로드합니다.
5. 각 워크북에 대해 첫 번째 워크시트의 이름을 바꿉니다.
6. 수정된 각 워크북을 원래 폴더 내의 'output' 폴더에 저장합니다.

산출

아래 출력에서 모든 3개의 파일이 이름이 변경되었으며, 그 안의 Excel 시트도 FinancialReport2024로 이름이 변경된 것을 볼 수 있습니다.

Excel 시트를 프로그래밍 방식으로 이름 변경하는 이점

• 효율성: 자동화는 수작업과 관련된 수고와 인간의 오류를 줄여 시간과 자원을 절약합니다.
• 일관성: 자동화된 이름 변경은 시트 전반에 걸쳐 일관성과 명명 규칙을 준수하여 데이터 조직과 가독성을 향상시킵니다.
• 확장성: 프로그래밍 방식으로 시트 이름을 변경하면 대량의 이름 변경과 확장성이 가능해 대량의 데이터 세트나 반복 작업 처리에 적합합니다.
• 통합성: 기존 워크플로우나 애플리케이션과의 통합은 매끄러운 데이터 처리와 전반적인 생산성 향상을 가능하게 합니다.
• 맞춤화: 자동화는 구체적인 비즈니스 요구사항이나 기준에 따라 이름 변경 로직을 맞춤화할 수 있는 유연성을 제공합니다.

라이선스

IronXL은 라이선스 계약과 함께 작동하는 기업용 라이브러리입니다. 여기에서 라이선스에 대한 정보를 더 많이 볼 수 있습니다. 라이선스 키는 여기 appsettings.json 파일에 입력해야 합니다.

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

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

결론

C#을 사용하여 Excel 파일의 이름을 바꾸는 것은 간단한 과정입니다. Iron Software의 IronXL 라이브러리를 활용하여 C# 애플리케이션 내에서 Excel 파일의 이름을 쉽게 변경할 수 있습니다. 이 라이브러리는 읽기, 쓰기, 관리 등 모든 Excel 시트 작업을 위한 개발자에게 유용한 도구입니다.

이제 Excel 파일의 이름을 프로그래밍 방식으로 바꾸는 방법을 배웠으므로, 파일 관리 작업을 간소화하고 자동화 기능을 개선하기 위해 C# 프로젝트에 이 기능을 통합할 수 있습니다.