C# CSV-Parser (Schritt-für-Schritt-Tutorial)

Sollte ich den Visual Studio NuGet Paketmanager verwenden?

Die NuGet Package Manager UI ist in Visual Studio verfügbar, um das Paket direkt in das Projekt zu installieren. Diese Methode ist besonders nützlich für Entwickler, die visuelle Oberflächen bevorzugen und sich vor der Installation über die Paketdetails informieren möchten. Der folgende Screenshot zeigt, wie man es öffnet.

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

Die Benutzeroberfläche des Paketmanagers bietet eine Suchfunktion, die eine Liste der auf der NuGet Website verfügbaren Paketbibliotheken anzeigt. Geben Sie "IronXL" ein, wie im Screenshot unten gezeigt, um das IronXL -Paket zu finden. Sie können auch die verwandten Excel-Bearbeitungsfunktionen von IronXL erkunden.

Der NuGet Paketmanager in Visual Studio zeigt die IronXL.Excel-Bibliothek an, mit der Entwickler Excel-Dateien in .NET Anwendungen lesen, generieren und bearbeiten können. Das Paket wird mit 250.000 Downloads und der Version 2022.9.9454 zur Installation bereit angezeigt.

Wählen Sie das Paket IronXL.Excel aus und klicken Sie auf die Schaltfläche "Installieren" , um es dem Projekt hinzuzufügen. Der Installationsprozess kümmert sich automatisch um alle Abhängigkeiten und konfiguriert Ihr Projekt für die Bearbeitung von Excel-Dateien .

Wann sollte ich die Visual Studio-Befehlszeile verwenden?

Gehen Sie im Visual Studio-Menü zu Extras > NuGet-Paket-Manager > klicken Sie auf Paket-Manager-Konsole. Diese Methode wird von Entwicklern bevorzugt, die mit Kommandozeilenschnittstellen vertraut sind oder den Installationsprozess in Build-Skripten automatisieren müssen.

Öffnen der NuGet Paket-Manager-Konsole in Visual Studio zum Installieren von CSV-Parsing-Bibliotheken

Die Paket-Manager-Konsole wird am unteren Bildschirmrand angezeigt. Geben Sie den folgenden Befehl ein und drücken Sie die Eingabetaste. IronXL wird installiert. Diese Methode ist besonders nützlich, wenn Sie bestimmte Versionen installieren müssen oder mit Bereitstellungsskripten für Azure- oder AWS-Umgebungen arbeiten.

Install-Package IronXL.Excel

Die Paket-Manager-Konsole zeigt die erfolgreiche Installation von IronXL.Excel Version 2022.11.10251 an und visualisiert den Wiederherstellungsprozess des Pakets sowie die Download-Bestätigungen aus dem NuGet Repository.

Wie konvertiere ich eine XLSX-Datei in eine CSV-Datei?

Öffnen Sie Microsoft Excel und erstellen Sie eine neue XLSX-Datei. Füllen Sie die Zeilen und Spalten mit einigen Beispieldaten. Für Produktionsszenarien empfiehlt es sich, Excel-Dateien programmatisch mit IronXL zu erstellen. Das untenstehende Bild zeigt die Datei, die für alle Konvertierungen in diesem Tutorial verwendet wurde.

Abbildung 6: Beispielhafte Excel-Daten, die eine grundlegende Inventarstruktur zeigen, die zur Demonstration des CSV-Parsings in C# verwendet wird

CSV-Dateien können in jedem Editor gelesen werden. Das folgende Bild zeigt die Ausgabe der generierten CSV-Daten. IronXL übernimmt die gesamte komplexe Datenanalyse intern, einschließlich der korrekten Behandlung von Sonderzeichen und Datentypen:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the XLSX file into a WorkBook object
        ' The Load method automatically detects the file format
        Dim wb As WorkBook = WorkBook.Load("test.xlsx")

        ' Save the WorkBook as a CSV file
        ' This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv")

        ' Optional: Save with custom delimiter
        ' wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";")
    End Sub
End Class

Nach Abschluss der Ausführung wird eine neue Datei mit dem Namen Parsed CSV.csv erstellt. Sie können CSV-Dateien mit jedem beliebigen Editor oder Reader öffnen. Sie können die CSV-Daten auch wieder in Excel importieren, um sie weiter zu bearbeiten. Das Bild unten zeigt die Ausgabe des obigen Befehls – unsere generierten CSV-Daten. In der Ausgabedatei stehen doppelte Anführungszeichen für fett gedruckte Werte.

Abbildung 7: Die mit der Methode SaveAsCsv generierte CSV-Ausgabe zeigt die konvertierten Excel-Daten im kommagetrennten Format an.

Wie konvertiert man XLS-Dateien in CSV?

In diesem Beispiel zeigen wir Ihnen, wie Sie XLS-Dateien in das CSV-Format konvertieren. Der Vorgang ist identisch mit der XLSX-Konvertierung und demonstriert damit die Vielseitigkeit von IronXL im Umgang mit verschiedenen Excel-Dateiformaten .

Erstellen wir ein XLS-Beispiel, das wir in CSV konvertieren. Beachten Sie, dass XLS ein älteres Excel-Format ist, IronXL es aber nahtlos neben modernen Formaten verarbeitet:

Abbildung 8: Eine Beispiel-Excel-Datei, die die Datenstruktur einer Inventarliste mit automatischen Berechnungen veranschaulicht und mithilfe von C#-CSV-Bibliotheken analysiert werden kann.

Als Nächstes führen wir den unten stehenden Codeblock aus, um die Beispiel-XLS-Datei in eine CSV-Datei zu konvertieren. IronXL erhält die Datenintegrität während der Konvertierung, einschließlich Formeln und Berechnungen .

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the XLS file into a WorkBook object
        ' IronXL automatically handles the older XLS format
        Dim wb As WorkBook = WorkBook.Load("XLS.xls")

        ' Save the WorkBook as a CSV file
        ' All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv")

        ' Optional: Export specific worksheet
        ' Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
        ' ws.SaveAsCsv("Example2.csv")
    End Sub
End Class

Nachdem der obige Code ausgeführt wurde, erhalten Sie eine neu generierte CSV-Datei. In komplexeren Szenarien empfiehlt es sich, vor dem Export bestimmte Bereiche auszuwählen oder die Daten zu sortieren.

Beispiel einer CSV-Datei, geöffnet in WordPad, die korrekt formatierte, kommagetrennte Daten mit Überschriften und mehreren Produkteinträgen zeigt.

Wie kann ich CSV-Dateien aus dem TSV-Format parsen?

Tabellenkalkulationsprogramme verwenden häufig TSV-Dateien (Tab-Separated Values), um Daten zwischen Datenbanken zu übertragen. Es speichert eine Datentabelle, in der die Datenspalten durch Tabulatoren getrennt sind und jeder Datensatz in einer eigenen Zeile steht. TSV-Dateien sind besonders nützlich, wenn Ihre Daten Kommas enthalten, die beim Parsen von CSV-Dateien Probleme verursachen könnten.

IronXL bietet einen CSV-Parser, um CSV-Dateien aus TSV-Format für eine bessere Datenverwaltung zu analysieren. Der Konvertierungsprozess ist unkompliziert und gewährleistet die Datenintegrität durchgehend.

Unten ist die Ausgabe im CSV-Format. Zuerst erstellen wir eine TSV-Datei mit den Schülerdaten:

Beispiel für tabulatorgetrennte Schülerdaten in Microsoft Word. Die Struktur einer TSV-Datei mit Spalten für NAME, E-MAIL, R-NO und Note wird dargestellt.

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the TSV file into a WorkBook object
        ' IronXL automatically detects tab-separated format
        Dim wb As WorkBook = WorkBook.Load("TSV.tsv")

        ' Save the WorkBook as a CSV file
        ' Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv")

        ' Alternative: Load with explicit delimiter specification
        ' Dim wb As WorkBook = WorkBook.LoadCSV("TSV.tsv", delimiter:=vbTab)
    End Sub
End Class

Unten sehen Sie die Ausgabe im CSV-Format. Beachten Sie, wie IronXL die tabulatorgetrennten Werte korrekt in kommagetrennte Werte umgewandelt hat, wobei die Datenstruktur erhalten blieb:

Beispiel einer CSV-Datei, geöffnet in WordPad, die Schülerdatensätze mit Feldern für Name, E-Mail-Adresse, Matrikelnummer und Note (durch Kommas getrennt) anzeigt.