Zum Fußzeileninhalt springen
IRONXL VERWENDEN

Wie man Excel-Arbeitsblätter in C# umbenennt

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 this article, we'll explore how to rename Excel files using IronXL library from Iron Software entwickelt wurde.

Wie man Excel-Arbeitsblätter in C# umbenennt

  1. Erstellen Sie ein Visual Studio-Projekt, um Excel-Blätter umzubenennen.
  2. Install IronXL library from Iron Software entwickelt wurde.
  3. Benennen Sie Excel-Blätter mit IronXL um.

IronXL library from Iron Software

IronXL is a powerful C# Excel library developed by 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. Lesen, Bearbeiten und Erstellen von Excel-Dateien: IronXL ermöglicht es Ihnen, Excel-Tabellendateien (einschließlich XLSX, XLS, XLSM, XLTX, CSV und TSV Formaten) direkt aus Ihrem C# oder VB.NET Code zu lesen, zu generieren 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 problemloses Erlebnis.
  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 es Ihnen, Aufgaben wie das Lesen von Zellwerten, das Berechnen von Aggregatwerten, das Arbeiten mit Formeln, das Erstellen von Diagrammen und mehr durchzuführen. 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");
            }
        }
    }
    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");
            }
        }
    }
    Imports IronXL
    
    Namespace RenameExcelSheets
    	Public Class Program
    		Public Shared Sub Main()
    			Console.WriteLine("Rename Excel Sheets Using IronXL")
    
    			' Load an existing Excel file into a WorkBook object
    			Dim workBook As WorkBook = WorkBook.Load("sample.xlsx") ' sample excel file
    
    			' Select the specified worksheet (first sheet)
    			Dim workSheet As WorkSheet = workBook.WorkSheets(0)
    
    			' Read a cell value from the workbook
    			Dim cellValue As Integer = workSheet("A2").IntValue
    
    			' Iterate through a range of cells and print their values
    			For Each cell In workSheet("A2:A10")
    				Console.WriteLine($"Cell {cell.AddressString} has value '{cell.Text}'")
    			Next cell
    
    			' Calculate aggregate values
    			Dim sum As Decimal = workSheet("A2:A10").Sum()
    			Dim max As Decimal = workSheet("A2:A10").Max(Function(c) c.DecimalValue)
    
    			' Save as a new workbook
    			workBook.SaveAs("sampleResult.xlsx")
    		End Sub
    	End Class
    End Namespace
    $vbLabelText   $csharpLabel
  5. Excel-Funktionalität ohne Aufwand: IronXL erlaubt es Ihnen, Tabellenkalkulationen mühelos zu erstellen, laden, speichern und zu 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.

Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 1 - Erstellen einer Konsolenanwendung

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

Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 2 - Projekt benennen

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

Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 3 - Erforderliche .NET-Version auswählen

Step 2: Install IronXL library from Iron Software entwickelt wurde.

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

Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 4 - IronXL mit NuGet-Paketmanager suchen

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

dotnet add package IronXL.Excel --version 2024.4.4

Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 5 - IronXL-Homepage

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.

Eingabe:

Wie man Excel-Arbeitsblätter in C# umbenennt: Abbildung 6 - Beispiel-Excel-Arbeitsblatt zur Umbenennung

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
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: workBook.SaveAs(Path.Combine(outputPath, string.Format("FinancialReport2024_{0}.xlsx", index++)));
				workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index}.xlsx"))
				index += 1
			Next file
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel

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.

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

Vorteile des programmatischen Umbenennens von Excel-Blättern umfassen

  • Effizienz: Automatisierung reduziert manuellen Aufwand und menschliche Fehler, die mit dem manuellen Umbenennen verbunden sind, wodurch Zeit und Ressourcen gespart werden.
  • Konsistenz: Automatisiertes Umbenennen sorgt für Einheitlichkeit und Einhaltung von Namenskonventionen über alle Blätter hinweg, verbessert die Datenorganisation und Lesbarkeit.
  • Skalierbarkeit: Das programmatische Umbenennen von Blättern ermöglicht Massenumbenennungen und Skalierbarkeit, was es für den Umgang mit großen Datensätzen oder sich wiederholenden Aufgaben geeignet macht.
  • Integration: Die Integration in vorhandene Workflows oder Anwendungen ermöglicht nahtlose Datenverarbeitung und steigert die Gesamteffizienz.
  • Anpassung: Automatisierung bietet Flexibilität, um Umbenennungslogik basierend auf spezifischen Geschäftsanforderungen oder Kriterien anzupassen.

Lizenzierung

IronXL ist eine Unternehmensbibliothek, die mit einem Lizenzabkommen arbeiten. Mehr über die Lizenz kann hier gefunden werden. Der Lizenzschlüssel muss in der appsettings.json-Datei hier platziert werden.

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

Abschluss

Das Umbenennen von Excel-Dateien mit C# ist ein unkomplizierter Prozess. By leveraging the IronXL library from Iron Software, you can easily rename Excel files within your C# applications. 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.

Häufig gestellte Fragen

Wie kann ich ein Excel-Arbeitsblatt in C# umbenennen, ohne Interop zu verwenden?

Sie können ein Excel-Arbeitsblatt in C# ohne die Verwendung von Interop umbenennen, indem Sie die IronXL-Bibliothek nutzen. Laden Sie Ihre Excel-Datei in ein WorkBook-Objekt, wählen Sie das umzubenennende Arbeitsblatt aus und setzen Sie seinen neuen Namen über die Name-Eigenschaft.

Welche Vorteile bietet die Verwendung von IronXL für die Manipulation von Excel-Dateien?

IronXL bietet leistungsstarke Fähigkeiten für die Manipulation von Excel-Dateien, wie das Lesen, Bearbeiten und Erstellen von Excel-Dateien, ohne Microsoft Excel oder Interop zu benötigen. Es unterstützt verschiedene Formate wie XLSX und CSV, bietet eine benutzerfreundliche API und ermöglicht Automatisierung und Integration in .NET-Projekte.

Ist es möglich, Excel-Aufgaben in C# zu automatisieren?

Ja, mit Hilfe der IronXL-Bibliothek können Sie verschiedene Excel-Aufgaben in C# automatisieren, z.B. Arbeitsblätter umbenennen, Zellwerte lesen, Aggregatberechnungen durchführen und vieles mehr, ohne Microsoft Excel zu benötigen.

Welche Schritte sind erforderlich, um IronXL für ein C#-Projekt einzurichten?

Um IronXL in einem C#-Projekt einzurichten, erstellen Sie zuerst ein Visual Studio-Projekt, installieren Sie dann die IronXL-Bibliothek mit dem NuGet-Paketmanager mit dem Befehl: dotnet add package IronXL.Excel --version 2024.4.4. Sie können dann seine Funktionen zur Manipulation von Excel-Dateien nutzen.

Kann IronXL mehrere Excel-Formate verarbeiten?

Ja, IronXL unterstützt mehrere Excel-Formate, einschließlich XLSX, XLS, XLSM, XLTX, CSV und TSV, was vielfältige Möglichkeiten zur Dateimanipulation in .NET-Anwendungen bietet.

Benötige ich eine Lizenz, um IronXL in meinem Projekt zu verwenden?

Ja, eine Lizenz ist erforderlich, um IronXL in Ihrem Projekt zu verwenden. Sobald Sie einen Lizenzschlüssel haben, sollte dieser in der Datei appsettings.json Ihres Projekts platziert werden, um die volle Funktionalität zu ermöglichen.

Wie behebe ich häufige Probleme bei der Verwendung von IronXL?

Häufige Probleme bei der Verwendung von IronXL können oft gelöst werden, indem sichergestellt wird, dass die Bibliothek korrekt installiert und konfiguriert ist, nach Updates gesucht wird und die offizielle Dokumentation zur Orientierung bei bestimmten Funktionen konsultiert wird.

Welche Vorteile bietet das programmatische Umbenennen von Excel-Arbeitsblättern?

Das programmatische Umbenennen von Excel-Arbeitsblättern verbessert die Effizienz und Skalierbarkeit, sorgt für Konsistenz, integriert sich nahtlos in bestehende Workflows und erlaubt Anpassungen basierend auf spezifischen Geschäftsanforderungen.

Jordi Bardia
Software Ingenieur
Jordi ist am besten in Python, C# und C++ versiert. Wenn er nicht bei Iron Software seine Fähigkeiten einsetzt, programmiert er Spiele. Mit Verantwortung für Produkttests, Produktentwicklung und -forschung trägt Jordi mit immensem Wert zur kontinuierlichen Produktverbesserung bei. Die abwechslungsreiche Erfahrung hält ihn gefordert und engagiert, ...
Weiterlesen