Umbenennen von Excel-Arbeitsblättern in C#

Einführung

Das programmgesteuerte Umbenennen von Excel-Dateien ist eine häufige Aufgabe in verschiedenen Anwendungen. Ganz gleich, ob Sie Dateien organisieren, Aufgaben automatisieren oder Daten verwalten, die Möglichkeit, Excel-Dateien durch Code umzubenennen, kann von großem Nutzen sein. In diesem Artikel werden wir erkunden, wie man Excel-Dateien mithilfe der IronXL-Bibliothek von Iron Software umbenennt.

Umbenennen von Excel-Arbeitsblättern in C#;

1. Erstellen Sie ein Visual Studio-Projekt zum Umbenennen von Excel-Blättern.

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

3. Benennen Sie Excel-Blätter mithilfe von IronXL um.

IronXL-Bibliothek von Iron Software

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

Hauptmerkmale von IronXL

1. Lesen, Bearbeiten und Erstellen von Excel-Dateien: IronXL ermöglicht es Ihnen, Excel-Tabellendateien (einschließlich XLSX, XLS, XLSM, XLTX, CSV und TSV Formate) direkt aus Ihrem C#- oder VB.NET-Code zu lesen, zu erstellen und zu bearbeiten.

2. Kein Office Interop erforderlich: Sie müssen Microsoft Office nicht installieren oder sich mit den Komplexitäten von Office Interop auseinandersetzen. IronXL bietet ein unkompliziertes Erlebnis.

3. Plattformübergreifende Unterstützung: IronXL ist für .NET 8, 7, 6, Core, Framework und Azure konzipiert. Egal, ob Sie Konsolenanwendungen, Webanwendungen oder Desktop-Software entwickeln, IronXL hat alles, was Sie brauchen.

   4. Benutzerfreundliche API: Die intuitive API ermöglicht es Ihnen, Aufgaben wie das Lesen von Zellwerten, das Berechnen von Aggregatwerten, das Arbeiten mit Formeln, das Erstellen von Diagrammen und mehr durchzuführen. Schauen wir uns kurz ein Beispiel an:

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

5. Excel-Funktionalität ohne Aufwand: IronXL ermöglicht es Ihnen, Tabellenkalkulationen mühelos zu erstellen, zu laden, zu speichern und zu bearbeiten. Egal, ob es um Metadaten, Berechtigungen, Formeln oder Styling geht, IronXL vereinfacht den Prozess.

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

Einrichten der Umgebung

Bevor Sie mit der Programmierung beginnen, sollten Sie sicherstellen, dass Sie die erforderlichen Werkzeuge 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 praktisches Beispiel für das Umbenennen einer Excel-Datei zu demonstrieren, schreiben wir ein Programm, das einen Ordner mit allen umzubenennenden Dateien nimmt und IronXL verwendet, um alle Dateien umzubenennen und sie dann im Ausgabeordner zu speichern.

Schritt 1: Erstellen Sie ein Visual Studio-Projekt zum Umbenennen von Excel-Blättern.

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

Geben Sie Namen für das Projekt und den Pfad zum Speichern der Dateien an.

Wählen Sie die gewünschte .NET-Version aus.

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

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

Oder kann über den NuGet Package Manager mit dem Befehl installiert werden.

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

Nach der Installation ist das Projekt bereit, mit der Codierung für die Umbenennung von Excel-Arbeitsblättern zu beginnen.

Schritt 3: Excel-Blätter umbenennen mit IronXL

Nachfolgend finden Sie das Programm zum Umbenennen aller Dateien und Arbeitsblätter in einem Verzeichnis für Geschäftsanwendungen.

Eingabe:

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

Code Erläuterung

1. Nehmen Sie den Ordnerpfad, um alle Dateien und ihre Arbeitsblätter umzubenennen

2. Prüfen, ob der Ordnerpfad eine leere Zeichenkette ist

3. Prüfen, ob der Ordnerpfad gültig ist

4. Alle Dateien im Ordner mit der Erweiterung xlsx abrufen

5. Iterieren Sie durch die Dateien und laden Sie das WorkBook-Objekt von IronXL, um die Eigenschaft Arbeitsblattname umzubenennen.

6. Speichern Sie die Datei im Ausgabeordner

   Ausgabe

   In der folgenden Ausgabe sehen Sie, dass alle 3 Dateien umbenannt wurden und dass die darin enthaltene Excel-Tabelle ebenfalls in FinancialReport2024 umbenannt wurde.

   

Die Vorteile der programmgesteuerten Umbenennung von Excel-Blättern sind

• Effizienz: Automatisierung reduziert den manuellen Aufwand und menschliche Fehler, die mit der manuellen Umbenennung verbunden sind, und spart Zeit und Ressourcen.
• Konsistenz: Die automatisierte Umbenennung sorgt für Einheitlichkeit und die Einhaltung von Namenskonventionen über Tabellen hinweg, was die Datenorganisation und Lesbarkeit verbessert.
• Skalierbarkeit: Das programmatische Umbenennen von Blättern ermöglicht eine Massenumbenennung und Skalierbarkeit, wodurch es sich für die Bearbeitung großer Datensätze oder sich wiederholender Aufgaben eignet.
• Integration: Die Integration in bestehende Workflows oder Anwendungen ermöglicht nahtlose Datenverarbeitung und verbessert die Gesamtproduktivität.
• Anpassung: Automatisierung bietet die Flexibilität, die Umbenennungslogik basierend auf spezifischen Geschäftsanforderungen oder Kriterien anzupassen.

Lizenzvergabe

IronXL ist eine Unternehmensbibliothek, die mit einer Lizenzvereinbarung arbeitet. Weitere Informationen zur Lizenz finden Sie hier. Der Lizenzschlüssel muss hier in der Datei appsettings.json abgelegt werden.

{
  "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

Schlussfolgerung

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 einfach innerhalb Ihrer C#-Anwendungen umbenennen. Diese Bibliothek ist ein praktisches Werkzeug für Entwickler für alle Excel-Tabellenoperationen, sei es Lesen, Schreiben oder Verwalten.

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