C# Parser CSV (Krok po kroku) Samouczek

Czy powinienem korzystać z menedżera pakietów NuGet w Visual Studio?

Interfejs użytkownika menedżera pakietów NuGet jest dostępny w programie Visual Studio i umożliwia bezpośrednią instalację pakietu w projekcie. Ta metoda jest szczególnie przydatna dla programistów, którzy preferują interfejsy wizualne i chcą zapoznać się ze szczegółami pakietu przed instalacją. Poniższy zrzut ekranu pokazuje, jak to otworzyć.

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

Interfejs użytkownika menedżera pakietów udostępnia funkcję przeglądania, która wyświetla listę bibliotek pakietów dostępnych na stronie internetowej NuGet. Wpisz "IronXL", jak pokazano na poniższym zrzucie ekranu, aby znaleźć pakiet IronXL. Możesz również zapoznać się z powiązanymi funkcjami manipulacji danymi w Excelu, które oferuje IronXL.

Menedżer pakietów NuGet w Visual Studio wyświetlający bibliotekę IronXL.Excel, która umożliwia programistom czytanie, generowanie i edytowanie plików Excel w aplikacjach .NET. Pakiet ma 250 tys. pobrań, a wersja 2022.9.9454 jest gotowa do instalacji.

Wybierz pakiet IronXL.Excel i kliknij przycisk Zainstaluj, aby dodać go do projektu. Proces instalacji automatycznie zajmie się wszystkimi zależnościami i skonfiguruje projekt do obsługi plików Excel.

Kiedy należy korzystać z wiersza poleceń programu Visual Studio?

W menu Visual Studio przejdź do Narzędzia > Menedżer pakietów NuGet > kliknij Konsola menedżera pakietów. Metoda ta jest preferowana przez programistów, którzy czują się swobodnie w interfejsach wiersza poleceń lub muszą zautomatyzować proces instalacji w skryptach kompilacji.

Otwieranie Konsoli Menedżera pakietów NuGet w Visual Studio, aby zainstalować biblioteki do parsowania CSV

Konsola menedżera pakietów pojawi się na dole ekranu. Wpisz następujące polecenie i naciśnij klawisz Enter. Zostanie zainstalowany IronXL. Ta metoda jest szczególnie przydatna, gdy trzeba zainstalować konkretne wersje lub podczas pracy ze skryptami wdrażania dla środowisk Azure lub AWS.

Install-Package IronXL.Excel

Konsola Menedżera pakietów wyświetla udaną instalację wersji 2022.11.10251 IronXL.Excel, pokazując proces przywracania pakietu i potwierdzenia pobierania z repozytorium NuGet

Jak przekonwertować plik XLSX na CSV?

Otwórz program Microsoft Excel i utwórz nowy plik XLSX. Wypełnij jego wiersze i kolumny przykładowymi danymi. W scenariuszach produkcyjnych warto rozważyć programowe tworzenie plików Excel przy użyciu IronXL. Poniższy obrazek przedstawia plik używany do wszystkich konwersji w tym samouczku.

Rysunek 6: Przykładowe dane Excel pokazujące podstawową strukturę inwentaryzacyjną, która będzie używana do demonstrowania parsowania CSV w C#

Gdy plik będzie gotowy, napisz poniższy przykładowy kod i uruchom program. IronXL wewnętrznie obsługuje wszystkie złożone operacje parsowania, w tym prawidłową obsługę znaków specjalnych i typów danych:

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

Po zakończeniu operacji zostanie utworzony nowy plik o nazwie Parsed CSV.csv. Pliki CSV można otwierać w dowolnym edytorze lub czytniku. Dane CSV można również zaimportować z powrotem do programu Excel w celu dalszej obróbki. Poniższy obrazek przedstawia wynik powyższego polecenia — wygenerowane przez nas dane w formacie CSV. W pliku wyjściowym podwójne cudzysłowy oznaczają wartości pogrubione.

Rysunek 7: Wyjście CSV wygenerowane przez metodę SaveAsCsv, wyświetlające przekonwertowane dane Excel w formacie rozdzielanym przecinkami

Jakie są kroki konwersji plików XLS do formatu CSV?

W tym przykładzie zobaczymy, jak przekonwertować pliki XLS do formatu CSV. Proces ten jest identyczny jak konwersja plików XLSX, co pokazuje wszechstronność IronXL w obsłudze różnych formatów plików Excel.

Najpierw utwórzmy przykładowy plik XLS, który możemy przekonwertować do formatu CSV. Należy pamiętać, że XLS jest starszym formatem programu Excel, ale IronXL obsługuje go płynnie obok nowoczesnych formatów:

Rysunek 8: Przykładowy plik Excel demonstrujący strukturę danych inwentaryzacyjnych z automatycznymi obliczeniami, który można parsować przy użyciu bibliotek CSV C#

Następnie uruchomimy poniższy blok kodu, aby przekonwertować przykładowy plik XLS na plik CSV. IronXL zachowuje integralność danych podczas konwersji, w tym formuły i obliczenia:

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

Po zakończeniu wykonywania powyższego kodu otrzymasz nowo wygenerowany plik CSV. W bardziej złożonych scenariuszach możesz wybrać określone zakresy lub posortować dane przed eksportem.

Przykładowy plik CSV otwarty w WordPad pokazujący poprawnie sformatowane dane rozdzielane przecinkami z nagłówkami i wieloma wpisami produktów

Jak mogę analizować pliki CSV z formatu TSV?

Aplikacje do obsługi arkuszy kalkulacyjnych często wykorzystują pliki TSV (Tab-Separated Values) do przesyłania danych między bazami danych. Zapisuje tabelę danych z tabulatorami oddzielającymi kolumny danych, a każdy rekord znajduje się w osobnym wierszu. Pliki TSV są szczególnie przydatne, gdy dane zawierają przecinki, które mogą zakłócać parsowanie plików CSV.

IronXL oferuje parser CSV do analizowania plików CSV z formatu TSV w celu lepszego zarządzania danymi. Proces konwersji jest prosty i zapewnia integralność danych na każdym etapie.

Zacznijmy od przykładu. Najpierw utworzymy plik TSV z danymi studentów:

Przykład danych studenckich rozdzielanych tabulatorami wyświetlonych w Microsoft Word, pokazujący strukturę pliku TSV z kolumnami dla NAZWISKO, EMAIL, R-NO i Ocena

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

Poniżej znajduje się wynik w formacie CSV. Zwróć uwagę, jak IronXL poprawnie przekształcił wartości rozdzielone tabulatorami na wartości rozdzielone przecinkami, zachowując strukturę danych:

Przykładowy plik CSV otwarty w WordPad wyświetlający rekordy studenckie z polami dla imienia, e-maila, numeru indeksu i oceny oddzielonymi przecinkami