IRONXL VERWENDEN

Umbenennen von Excel-Arbeitsblättern in C#

Veröffentlicht 29. April 2024
Teilen Sie:

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 erfahren Sie, wie Sie Excel-Dateien umbenennen können IronXL bibliothek von Iron Software.

Umbenennen von Excel-Arbeitsblättern in C#;

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

  2. Installieren Sie IronXL bibliothek von Iron Software.

  3. Excel-Blätter umbenennen mit IronXL.

IronXL Bibliothek von Iron Software

IronXL ist eine leistungsstarke C#-Excel-Bibliothek, die 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 das Lesen, Erstellen und Bearbeiten von Excel-Tabellen (einschließlich der Formate XLSX, XLS, XLSM, XLTX, CSV und TSV) direkt von Ihrem C#- oder VB.NET-Code aus.

  2. Keine Office-Interop erforderlich: Sie müssen weder Microsoft Office installieren noch sich mit der Komplexität von Office Interop befassen. IronXL bietet eine problemlose Erfahrung.

  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.

    1. Benutzerfreundliches API: Mit der intuitiven API können Sie Aufgaben wie das Lesen von Zellwerten, die Berechnung von Aggregatwerten, die Arbeit mit Formeln, die Erstellung von Diagrammen und vieles mehr durchfü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
VB   C#
  1. Excel-Funktionalität ohne den Aufwand: IronXL ermöglicht das mühelose Erstellen, Laden, Speichern und Bearbeiten von Tabellenkalkulationen. 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 die richtige Bibliothek für Sie!

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.

Umbenennen von Excel-Arbeitsblättern in C#: Abbildung 1 - Erstellen einer Konsolenanwendung

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

Umbenennen von Excel-Arbeitsblättern in C#: Abbildung 2 - Benennen Sie das Projekt

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

Umbenennen von Excel-Arbeitsblättern in C#: Abbildung 3 - Wählen Sie die gewünschte .NET-Version

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

IronXL bibliothek kann über den Visual Studio Package Manager wie folgt installiert werden.

Umbenennen von Excel-Arbeitsblättern in C#: Abbildung 4 - Suche nach IronXL mit NuGet Package Manager

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
VB   C#

Umbenennen von Excel-Arbeitsblättern in C#: Abbildung 5 - IronXL-Homepage

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

Schritt 3: Umbenennen von Excel-Blättern mit IronXL

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

Eingabe:

Umbenennen von Excel-Arbeitsblättern in C#: Abbildung 6 - Beispiel Excel-Arbeitsblatt-Eingabe für die Umbenennung

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#

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

    Output

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

    Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 7 - Beispielausgabe, die alle mit IronXL umbenannten Excel-Arbeitsblätter zeigt

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

  • Effizienz: Die Automatisierung verringert den manuellen Aufwand und die menschlichen Fehler, die mit der manuellen Umbenennung verbunden sind, und spart so Zeit und Ressourcen.
  • Konsistenz: Die automatische Umbenennung sorgt für Einheitlichkeit und die Einhaltung von Namenskonventionen in allen Blättern und verbessert so die Organisation und Lesbarkeit der Daten.
  • Skalierbarkeit: Die programmatische Umbenennung von Blättern ermöglicht eine Massenumbenennung und Skalierbarkeit, so dass sie sich für die Bearbeitung großer Datenmengen oder sich wiederholender Aufgaben eignet.
  • Integration: Die Integration in bestehende Workflows 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.

Lizenzvergabe

IronXL ist eine Unternehmensbibliothek, die mit einer Lizenzvereinbarung arbeitet. Weitere Informationen zur Lizenz finden Sie unter 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
VB   C#

Schlussfolgerung

Das Umbenennen von Excel-Dateien mit C# ist ein unkomplizierter Prozess. Durch die Nutzung des IronXL bibliothek von Iron Softwarekönnen Sie Excel-Dateien innerhalb Ihrer C#-Anwendungen einfach 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.

< PREVIOUS
C# Excel-Schriftstil verwenden
NÄCHSTES >
Wie man eine Excel-Datei in einer C#-Konsolenanwendung liest

Sind Sie bereit, loszulegen? Version: 2024.10 gerade veröffentlicht

Gratis NuGet-Download Downloads insgesamt: 1,068,832 Lizenzen anzeigen >