Wie man Excel-Dateien in C# öffnet

Was sind die Hauptfunktionen von IronXL?

• Öffnen, lesen und durchsuchen Sie Daten in den Formaten XLS/XLSX/CSV/TSV mit LoadSpreadsheets.
• Exportieren Sie Excel-Arbeitsblätter in mehrere Formate mit Speichern & Exportieren.
• Dateien mit Passwörtern verschlüsseln und entschlüsseln mit sicheren Funktionen.
• Arbeiten Sie mit Excel-Tabellen als DataSet und DataTable Objekte über die DataSet-Integration.
• Excel Formeln werden automatisch neu berechnet, Unterstützung von Mathematische Funktionen.
• Bearbeiten Sie Tabellenkalkulationsdaten mit intuitiver Bereichssyntax wie WorkSheet["A1:B10"].
• Zellbereiche sortieren, Spalten und Zeilen.
• Formatieren Sie Zellen mit Schriftart, Hintergrund, Rand, Ausrichtung und Zahlenformaten.

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 zur Entwicklung von C# .NET-Anwendungen. Sie können Visual Studio von der Microsoft-Website herunterladen und installieren. Sie können auch JetBrains ReSharper & Rider verwenden. Für zusätzliche Hinweise zur Einrichtung siehe Erste Schritte Übersicht.
2. IronXL - Die Excel-Bibliothek, die bei der Arbeit mit Excel-Blättern in C# hilft. Es muss in Ihrer C#-Anwendung installiert werden, bevor Sie es verwenden. Sie können es von der NuGet-Website oder über das NuGet-Paketverwaltungssystem in Visual Studio herunterladen. Sie können auch die .NET Excel DLL-Datei direkt herunterladen. Für die Implementierung der Lizenzierung siehe Lizenzschlüssel verwenden.

Welche Namespaces sollte 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 vorhandene 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 WorkBook Klasse und der Load Methode. Die LoadSpreadsheets Funktionalität 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 eine WorkBook Instanz. Um ein bestimmtes WorkSheet zu öffnen, rufen Sie es aus der WorkSheets Sammlung ab. Der Arbeitsblattverwaltung-Leitfaden bietet mehr Details zu Arbeitsblattoperationen:

// 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-Datei

Wie lese ich Daten aus Excel-Zellen?

Sobald die Excel-Datei geöffnet ist, ist sie bereit für das Lesen von Daten. Daten aus Excel-Dateien in C# mit IronXL zu lesen, ist unkompliziert. Sie können Zellwerte lesen, indem Sie den Zellenbezug mit der Bereichauswahl-Funktionalität 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:

Excel lesen

Um Daten aus einem Zellbereich zu lesen, verwenden Sie eine Schleife, um durch den angegebenen Bereich zu iterieren. Das Excel-Bereich auswählen Beispiel bietet mehr 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 abgerufen und in der Konsole ausgegeben.

Bereich von Zellen lesen

Für detailliertere Lese- und Schreibbeispiele siehe das Excel-Lese-Tutorial in C#. Sie können Excel-Dateien auch in DataTables konvertieren für eine einfachere Manipulation:

// 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 erleichtert auch das Erstellen neuer Arbeitsmappen für das Speichern und Abrufen von Daten. Der Tabellenkalkulationen erstellen-Leitfaden bietet 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. Für fortgeschrittenere Erstellungs-Muster siehe Neue Excel-Datei erstellen.

Wie fügt man einem Workbook Arbeitsblätter 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 die Verwaltung von Arbeitsblättern und das 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:

Wert zur Zelle hinzufügen

Arbeiten mit verschiedenen Excel-Formaten

IronXL unterstützt mehrere Excel-Formate. So verwalten Sie verschiedene Dateitypen:

// 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 das Konvertieren von Tabellenkalkulationsdateitypen und das Konvertieren von XLSX in CSV, JSON, XML.

Fehlerbehandlung und bewährte Praktiken

Bei der Arbeit mit Excel-Dateien implementieren Sie eine ordnungsgemäße Fehlerbehandlung:

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 denken Sie über die Einrichtung des Protokolls und die Implementierung ordnungsgemäßer Fehlerbehandlungs-Muster nach.