Das programmgesteuerte Umbenennen von Excel-Dateien ist eine gängige Aufgabe in verschiedenen Anwendungen. Egal, ob Sie Dateien organisieren, Aufgaben automatisieren oder Daten verwalten, die Möglichkeit, Excel-Dateien per Code umzubenennen, kann äußerst vorteilhaft sein. In diesem Artikel werden wir erkunden, wie man Excel-Dateien mit der IronXL-Bibliothek von Iron Software umbenennt.

How to Rename Excel WorkSheet in C#

1. Erstellen Sie ein Visual Studio-Projekt, um Excel-Blätter umzubenennen.
2. Installieren Sie die IronXL-Bibliothek von Iron Software.
3. Benennen Sie Excel-Blätter mit IronXL um.

IronXL-Bibliothek von Iron Software

IronXL ist eine leistungsstarke C# Excel-Bibliothek, die von Iron Software entwickelt wurde. Sie ermöglicht es Ihnen, mit Excel-Dokumenten in Ihren .NET-Projekten zu arbeiten, ohne Microsoft Office oder Excel Interop zu benötigen.

Wichtige Funktionen von IronXL

1. Excel-Dateien lesen, bearbeiten und erstellen: Mit IronXL können Sie Excel-Tabellenkalkulationsdateien (einschließlich der Formate XLSX, XLS, XLSM, XLTX, CSV und TSV) direkt aus Ihrem C#- oder VB .NET Code lesen, generieren und bearbeiten.

2. Keine Office-Interop-Kompatibilität erforderlich: Sie müssen Microsoft Office nicht installieren und sich nicht mit den komplexen Anforderungen der Office-Interop-Kompatibilität auseinandersetzen. IronXL bietet Ihnen eine problemlose Benutzererfahrung.

3. Plattformübergreifende Unterstützung: IronXL ist für .NET 8, 7, 6, Core, Framework und Azure ausgelegt. Egal, ob Sie Konsolenanwendungen, Web-Apps oder Desktop-Software entwickeln, IronXL hat die passende Lösung.

4. Benutzerfreundliche API: Die intuitive API ermöglicht Ihnen die Durchführung von Aufgaben wie das Lesen von Zellwerten, das Berechnen von Aggregatwerten, das Arbeiten mit Formeln, das Erstellen von Diagrammen und vieles mehr. Lassen Sie uns kurz ein Beispiel untersuchen:

   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. Excel-Funktionalität ohne Aufwand: Mit IronXL können Sie Tabellenkalkulationen mühelos erstellen, laden, speichern und bearbeiten. Egal, ob Sie sich mit Metadaten, Berechtigungen, Formeln oder Formatierungen befassen, IronXL vereinfacht den Prozess.

Denken Sie daran, IronXL wird von Millionen von Ingenieuren weltweit wegen seiner Genauigkeit, Benutzerfreundlichkeit und Geschwindigkeit vertraut. Wenn Sie mit Excel-Dateien in C# oder VB.NET arbeiten, ist IronXL Ihre bevorzugte Bibliothek!

Einrichten der Umgebung

Bevor Sie mit dem Codeteil beginnen, stellen Sie sicher, dass Sie die notwendigen Tools installiert haben:

1. Visual Studio: Installieren Sie Visual Studio oder eine andere bevorzugte C#-IDE.
2. Microsoft Excel: Stellen Sie sicher, dass Microsoft Excel auf Ihrem System installiert ist.

Um ein praxisnahes Beispiel zum Umbenennen einer Excel-Datei zu demonstrieren, lassen Sie uns ein Programm schreiben, das einen Ordner mit allen umbenennbaren Dateien nimmt, IronXL zum Umbenennen aller Dateien verwendet und sie dann im Ausgabeverzeichnis speichert.

Schritt 1: Erstellen Sie ein Visual Studio-Projekt, um Excel-Blätter umzubenennen.

Öffnen Sie Visual Studio und erstellen Sie ein neues Projekt für die Demo. Wählen Sie Konsolenanwendung aus der unten stehenden Vorlage.

Geben Sie dem Projekt einen Namen und einen Pfad zum Speichern der Dateien an.

Wählen Sie die erforderliche .NET-Version aus.

Schritt 2: Installieren Sie die IronXL-Bibliothek von Iron Software.

Die IronXL-Bibliothek kann über den Visual Studio-Paketmanager wie unten beschrieben installiert werden.

Oder kann mit dem Befehl aus dem NuGet-Paketmanager installiert werden.

dotnet add package IronXL.Excel --version 2024.4.4

Nach der Installation ist das Projekt bereit, mit dem Codieren zum Umbenennen von Excel-Arbeitsblättern zu beginnen.

Schritt 3: Benennen Sie Excel-Blätter mit IronXL um

Unten ist das Programm zum Umbenennen aller Dateien und Arbeitsblätter in einem Verzeichnis für Geschäftsapplikationen.

Eingang:

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

Code-Erklärung

1. Das Programm fordert den Benutzer auf, einen Ordnerpfad einzugeben, in dem sich Excel-Dateien befinden.
2. Es überprüft, ob der Ordnerpfad eine leere Zeichenkette ist und ob der Ordner tatsächlich existiert.
3. Es ruft alle Dateien aus dem angegebenen Ordner ab.
4. Es durchläuft diese Dateien und lädt jede in ein WorkBook-Objekt aus der IronXL-Bibliothek.
5. Für jedes Workbook wird das erste Arbeitsblatt umbenannt.
6. Es speichert jedes modifizierte Workbook in einem "output"-Ordner im Originalordner.

Ausgabe

Im folgenden Output sehen Sie, dass alle 3 Dateien umbenannt und das Excel-Arbeitsblatt darin ebenfalls in FinancialReport2024 umbenannt wurden.

Vorteile des programmatischen Umbenennens von Excel-Blättern umfassen

• Effizienz: Durch Automatisierung werden der manuelle Aufwand und menschliche Fehler bei der manuellen Umbenennung reduziert, wodurch Zeit und Ressourcen gespart werden.
• Konsistenz: Die automatische Umbenennung gewährleistet Einheitlichkeit und die Einhaltung der Namenskonventionen in allen Tabellenblättern und verbessert so die Datenorganisation und Lesbarkeit.
• Skalierbarkeit: Durch die programmatische Umbenennung von Tabellenblättern ist eine Massenumbenennung und Skalierbarkeit möglich, wodurch sich das Verfahren für die Bearbeitung großer Datensätze oder wiederkehrender Aufgaben eignet.
• Integration: Die Integration in bestehende Arbeitsabläufe oder Anwendungen ermöglicht eine nahtlose Datenverarbeitung und steigert die Gesamtproduktivität.
• Anpassung: Die Automatisierung bietet die Flexibilität, die Umbenennungslogik auf der Grundlage spezifischer Geschäftsanforderungen oder Kriterien anzupassen.

Lizenzierung

IronXL ist eine Unternehmensbibliothek, die mit einem Lizenzvertrag funktioniert. Mehr über die Lizenz kann hier gefunden werden. Der Lizenzschlüssel muss hier in die appsettings.json-Datei eingegeben werden.

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

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

Abschluss

Das Umbenennen von Excel-Dateien mit C# ist ein unkomplizierter Prozess. Durch die Nutzung der IronXL-Bibliothek von Iron Software können Sie Excel-Dateien mühelos in Ihren C#-Anwendungen umbenennen. Diese Bibliothek ist ein praktisches Werkzeug für Entwickler bei allen Excel-Blatt-Operationen, sei es beim Lesen, Schreiben oder Verwalten.

Da Sie nun gelernt haben, wie man Excel-Dateien programmgesteuert umbenennt, können Sie diese Funktion in Ihre C#-Projekte integrieren, um Dateiverwaltungsaufgaben zu rationalisieren und die Automatisierungsmöglichkeiten zu verbessern.