Wie man Excel-Dateien in C# öffnet

Was sind die wichtigsten Merkmale von IronXL?

• Daten in den Formaten XLS/XLSX/CSV/TSV mit LoadSpreadsheets öffnen, lesen und durchsuchen.
• Exportieren Sie Excel-Arbeitsblätter in verschiedene Formate mit der Funktion "Speichern & Exportieren" .
• Dateien mit Passwörtern unter Verwendung sicherer Funktionen verschlüsseln und entschlüsseln.
• Arbeiten mit Excel-Tabellen als DataSet und DataTable Objekte durch DataSet-Integration .
• Excel- Formeln werden automatisch neu berechnet und unterstützen mathematische Funktionen .
• Bearbeiten Sie Tabellendaten mit einer intuitiven Bereichssyntax wie WorkSheet["A1:B10"] .
• Zellbereiche , Spalten und Zeilen sortieren.
• Zellen mit Schriftart , Hintergrund , Rahmen , Ausrichtung und Zahlenformaten formatieren .

Was benötige ich vor dem Start?

Um IronXL in C#-Anwendungen zu verwenden, installieren Sie die folgenden Komponenten auf Ihrem lokalen Computer:

1. Visual Studio – Die offizielle IDE für die Entwicklung von C# .NET-Anwendungen. Sie können Visual Studio von der Microsoft-Website herunterladen und installieren. Alternativ können Sie auch JetBrains ReSharper & Rider verwenden. Weitere Hinweise zur Einrichtung finden Sie in der Übersicht "Erste Schritte" .
2. IronXL - Die Excel-Bibliothek, die die Arbeit mit Excel-Tabellen in C# erleichtert. Es muss in Ihrer C#-Anwendung installiert werden, bevor Sie es verwenden. Sie können es von der NuGet-Website oder über die Verwaltung von NuGet-Paketen in Visual Studio herunterladen. Sie können auch die .NET Excel DLL-Datei direkt herunterladen. Informationen zur Lizenzimplementierung finden Sie unter Verwendung von Lizenzschlüsseln .

Welche Namensräume soll ich importieren?

Sobald Visual Studio und IronXL installiert sind, fügen Sie die notwendigen IronXL-Namespace durch Hinzufügen der folgenden Zeile am Anfang Ihrer C#-Datei ein:

// Add reference to the IronXL library
using IronXL;

// Add reference to the IronXL library
using IronXL;

Für die Arbeit mit bestimmten Excel-Formaten oder erweiterten Funktionen benötigen Sie möglicherweise auch:

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

Wie lade ich eine bestehende Excel-Datei?

Excel-Dateien, auch bekannt als Arbeitsmappen, bestehen aus mehreren Arbeitsblättern, die jeweils Zellwerte enthalten. Um eine Excel-Datei zu öffnen und zu lesen , laden Sie sie mit der Load Methode der WorkBook Klasse. Die LoadSpreadsheets- Funktion unterstützt verschiedene Formate.

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

Dies initialisiert die Arbeitsmappe als WorkBook-Instanz. Um ein bestimmtes WorkSheet zu öffnen, rufen Sie es aus der Sammlung WorkSheets ab. Der Leitfaden "Arbeitsblatt verwalten" enthält weitere Details zu den Vorgängen in Arbeitsblättern:

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

Damit wird das erste Blatt in der Excel-Datei aufgerufen, bereit zum Lesen und Schreiben.

! Excel-Tabelle mit Mitarbeiterdaten, Spalten für Name, Position und Gehalt für 5 Mitarbeiter, mit formatierten Überschriften und Zellrahmen Excel-Datei

Wie lese ich Daten aus Excel-Zellen aus?

Sobald die Excel-Datei geöffnet ist, können die Daten gelesen werden. Daten aus Excel-Dateien in C# mit IronXL zu lesen, ist unkompliziert. Sie können Zellwerte lesen, indem Sie die Zellreferenz mithilfe der Funktion "Bereich auswählen" angeben.

Der folgende Code ruft den Wert einer Zelle ab:

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

Das Ergebnis ist wie folgt:

Das Debug-Konsolenfenster von Microsoft Visual Studio zeigt die erfolgreiche Extraktion des Werts "100000" aus der Excel-Zelle C2 mit kontextbezogener Ausgabemeldung an . Excel lesen

Um Daten aus einem Zellbereich zu lesen, verwenden Sie eine Schleife, um den angegebenen Bereich zu durchlaufen. Das Beispiel "Excel-Bereich auswählen" liefert weitere Muster:

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

Jeder Wert im Zellbereich A2:A6 wird aufgerufen und in die Konsole ausgegeben.

Die Microsoft Visual Studio-Debugkonsole mit Syntaxhervorhebung zeigt die Ausgabe des gelesenen Excel-Bereichs A2:A6 mit den Mitarbeiternamen John, Sara, Peter, Method und Katherine. Bereich von Zellen lesen

Für detailliertere Lese- und Schreibbeispiele konsultieren Sie bitte das Excel-Lese-Tutorial in C# . Sie können Excel-Daten auch in DataTables konvertieren, um sie einfacher bearbeiten zu können:

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

Wie kann ich eine neue Excel-Datei erstellen?

IronXL ermöglicht außerdem das Erstellen neuer Arbeitsmappen zum Speichern und Abrufen von Daten. Der Leitfaden "Tabellenkalkulationen erstellen" enthält umfassende Beispiele.

Sie können eine neue Excel-Datei mit einer einzigen Codezeile erstellen:

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

Erstellen Sie ein Arbeitsblatt und fügen Sie Daten hinzu. Weitere Informationen zu fortgeschrittenen Erstellungsmustern finden Sie unter Erstellen einer neuen Excel-Datei .

Wie füge ich Arbeitsblätter zu einer Arbeitsmappe hinzu?

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

Dieser Code fügt der Arbeitsmappe ein Arbeitsblatt namens "GDPByCountry" hinzu, das Ihnen ermöglicht, Zellwerte hinzuzufügen. Erfahren Sie mehr über das Verwalten und Kopieren von Arbeitsblättern .

Für eine bestimmte Zelle setzen Sie den Wert mit diesem Code:

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

Das endgültige Ergebnis ist:

! Excel-Tabelle, in der Zelle A1 mit dem programmgesteuert per C# hinzugefügten Text "Beispiel" gefüllt ist; das Tabellenblatt "GDPByCountry" ist sichtbar und die Zelle ist hervorgehoben, um den hinzugefügten Wert anzuzeigen. Wert zur Zelle hinzufügen

Arbeiten mit verschiedenen Excel-Formaten

IronXL unterstützt mehrere Excel-Formate. So gehen Sie mit verschiedenen Dateitypen um:

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

Erfahren Sie mehr über die Konvertierung von Tabellenkalkulationsdateitypen und die Konvertierung von XLSX in CSV, JSON, XML .

Fehlerbehandlung und bewährte Praktiken

Bei der Arbeit mit Excel-Dateien ist eine angemessene Fehlerbehandlung zu implementieren:

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

Für Produktionsanwendungen empfiehlt sich die Einrichtung von Protokollierung und die Implementierung geeigneter Fehlerbehandlungsmuster .