1.0 Wprowadzenie

W niniejszym artykułe wykorzystamy jedną z najbardziej znanych bibliotek, IronXL, aby zestawić i porównać różne sposoby programowego łączenia technologii .NET z dokumentami Microsoft Excel. Stworzy również środowisko do odczytu, zapisu i eksportowania arkuszy kalkulacyjnych Excel do plików CSV.

2.0 IronXL

IronXL dla .NET, biblioteka C# dla programu Excel, może służyć do odczytu i konwersji dokumentów Microsoft Excel do plików CSV. IronXL jest samodzielną biblioteką oprogramowania .NET, która może być używana bez instalacji Microsoft Office lub Microsoft.Office.Interop.Excel. Obsługuje wiele formatów arkuszy kalkulacyjnych.

Arkusze kalkulacyjne Excel można z łatwością odczytywać, edytować i generować w środowisku .NET dzięki prostemu interfejsowi API C# biblioteki IronXL. Xamarin, Linux, macOS, Azure, .NET Core i .NET Framework są w pełni obsługiwane przez IronXL.

2.1 Funkcje biblioteki IronXL

• Jedną z najlepszych bibliotek C# do obsługi arkuszy kalkulacyjnych Excel jest IronXL, która działa zarówno z .NET Core, jak i .NET Framework.
• IronXL obsługuje praktycznie wszystkie wersje .NET Framework, w tym aplikacje konsolowe, Windows Forms i aplikacje internetowe.
• Systemy Windows, macOS i Linux są kompatybilne z IronXL.
• Dzięki IronXL można szybko i łatwo uzyskać dostęp do plików Excel.
• Formaty plików Excel, takie jak pliki XLSX, CSV, XLS, XSLT, TSV, XLSM i inne, mogą być odczytywane przez IronXL. Wśród wielu możliwości znajdują się funkcje importowania, aktualizowania i eksportowania zbiorów danych oraz tabel danych.
• Obliczenia dla arkusza kalkulacyjnego Excel mogą być generowane przez IronXL.
• W przypadku kolumn w Excelu IronXL obsługuje szeroki zakres typów danych, takich jak tekst, liczby całkowite, daty, waluty, formuły i wartości procentowe.
• IronXL obsługuje daty, waluty, wartości procentowe, tekst, liczby, formuły oraz inne typy danych występujące w kolumnach arkusza kalkulacyjnego Excel.

3.0 Tworzenie projektu .NET Core 6

W kolejnych sekcjach tego biuletynu zobaczysz, jak łatwo jest utworzyć plik CSV przy użyciu biblioteki IronXL.

Krok 1: Utwórz nowy projekt w celu wygenerowania pliku CSV.

Otwórz program Visual Studio i wybierz opcję "Nowy projekt" z menu "Plik".

W wyświetlonym oknie dialogowym wybierz szablony projektu .NET "Console App", a następnie kliknij "Dalej".

Utwórz nową aplikację konsolową w Visual Studio

W polu "Nazwa projektu" można wpisać dowolną nazwę. Po podaniu lokalizacji nowego projektu w sekcji "Lokalizacja" kliknij przycisk Dalej, aby kontynuować.

Skonfiguruj nowy projekt

Menu rozwijane Framework służy do wyboru platformy .NET Framework. W tym przypadku wersją .NET z długoterminowym wsparciem jest 6.0. Następnie kliknij przycisk Utwórz.

Wybór docelowej platformy .NET Framework

Zainstaluj bibliotekę IronXL, ponieważ jest ona niezbędna do dalszego działania. Aby to zrobić, wpisz następujące polecenie w konsoli menedżera pakietów:

Install-Package IronXL.Excel

Zainstaluj pakiet IronXL

Alternatywą jest wyszukanie pakietu "IronXL" za pomocą menedżera pakietów NuGet. W zakładce Przeglądaj wpisz "IronXL" w polu wyszukiwania, aby znaleźć bibliotekę IronXL. Z poniższej listy wszystkich pakietów NuGet związanych z IronXL wybierz pakiet, który chcesz pobrać.

Wyszukaj i zainstaluj pakiet IronXL w interfejsie użytkownika NuGet Package Manager

4.0 Eksport danych do pliku CSV

Dzięki IronXL tworzenie tabel danych w plikach CSV jest proste i szybkie. Ułatwia zapisywanie danych do nowego pliku CSV. Pierwszym krokiem jest dołączenie przestrzeni nazw IronXL, jak widać na poniższym zrzucie ekranu z kodem. Po przedstawieniu IronXL jego klasy i metody mogą być wykorzystywane w kodzie.

Uwzględnij przestrzeń nazw IronXL

IronXL może być używany do tworzenia plików Excel, które są następnie przekształcane w obiekty WorkBook. Gdy staną się obiektami z klasy WorkBook, możliwe jest praca nad nimi na kilka sposobów. Przekształcając DataTable w arkusz Excel, poniższy przykład kodu źródłowego tworzy plik Excel.

using IronXL;
using System.Data;

class Program
{
    static void Main(string[] args)
    {
        ExportToExcel("test.csv");
    }

    // Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    public static void ExportToExcel(string filepath)
    {
        // Create a DataTable and add columns & rows
        DataTable table = new DataTable();
        table.Columns.Add("DataSet_Animals", typeof(string));
        table.Rows.Add("Lion");
        table.Rows.Add("Tiger");
        table.Rows.Add("Leopard");
        table.Rows.Add("Cheetah");
        table.Rows.Add("Hyenas");

        // Create a new workbook and get the default worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLS);
        var worksheet = workbook.DefaultWorkSheet;

        // Add table data to worksheet
        int rowCount = 1;
        foreach (DataRow row in table.Rows)
        {
            worksheet["A" + rowCount].Value = row[0].ToString();
            rowCount++;
        }

        // Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";");
        
        // Optionally convert workbook to a stream, useful for web applications
        var stream = workbook.ToStream();
    }
}

using IronXL;
using System.Data;

class Program
{
    static void Main(string[] args)
    {
        ExportToExcel("test.csv");
    }

    // Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    public static void ExportToExcel(string filepath)
    {
        // Create a DataTable and add columns & rows
        DataTable table = new DataTable();
        table.Columns.Add("DataSet_Animals", typeof(string));
        table.Rows.Add("Lion");
        table.Rows.Add("Tiger");
        table.Rows.Add("Leopard");
        table.Rows.Add("Cheetah");
        table.Rows.Add("Hyenas");

        // Create a new workbook and get the default worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLS);
        var worksheet = workbook.DefaultWorkSheet;

        // Add table data to worksheet
        int rowCount = 1;
        foreach (DataRow row in table.Rows)
        {
            worksheet["A" + rowCount].Value = row[0].ToString();
            rowCount++;
        }

        // Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";");
        
        // Optionally convert workbook to a stream, useful for web applications
        var stream = workbook.ToStream();
    }
}

Imports IronXL
Imports System.Data

Module Program
    Sub Main(args As String())
        ExportToExcel("test.csv")
    End Sub

    ' Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    Public Sub ExportToExcel(filepath As String)
        ' Create a DataTable and add columns & rows
        Dim table As New DataTable()
        table.Columns.Add("DataSet_Animals", GetType(String))
        table.Rows.Add("Lion")
        table.Rows.Add("Tiger")
        table.Rows.Add("Leopard")
        table.Rows.Add("Cheetah")
        table.Rows.Add("Hyenas")

        ' Create a new workbook and get the default worksheet
        Dim workbook = WorkBook.Create(ExcelFileFormat.XLS)
        Dim worksheet = workbook.DefaultWorkSheet

        ' Add table data to worksheet
        Dim rowCount As Integer = 1
        For Each row As DataRow In table.Rows
            worksheet("A" & rowCount).Value = row(0).ToString()
            rowCount += 1
        Next

        ' Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";")

        ' Optionally convert workbook to a stream, useful for web applications
        Dim stream = workbook.ToStream()
    End Sub
End Module

Imports IronXL
Imports System.Data

Module Program
    Sub Main(args As String())
        ExportToExcel("test.csv")
    End Sub

    ' Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    Public Sub ExportToExcel(filepath As String)
        ' Create a DataTable and add columns & rows
        Dim table As New DataTable()
        table.Columns.Add("DataSet_Animals", GetType(String))
        table.Rows.Add("Lion")
        table.Rows.Add("Tiger")
        table.Rows.Add("Leopard")
        table.Rows.Add("Cheetah")
        table.Rows.Add("Hyenas")

        ' Create a new workbook and get the default worksheet
        Dim workbook = WorkBook.Create(ExcelFileFormat.XLS)
        Dim worksheet = workbook.DefaultWorkSheet

        ' Add table data to worksheet
        Dim rowCount As Integer = 1
        For Each row As DataRow In table.Rows
            worksheet("A" & rowCount).Value = row(0).ToString()
            rowCount += 1
        Next

        ' Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";")

        ' Optionally convert workbook to a stream, useful for web applications
        Dim stream = workbook.ToStream()
    End Sub
End Module

Powyższy przykład CSV pokazuje, jak eksportować DataTable do pliku CSV. Po ustanowieniu DataTable, tzn. po stworzeniu nagłówków kolumn i ustanowieniu pierwszej kolumny, wiersze są dodawane pojedynczo. Po dodaniu wierszy i kolumn do obiektu DataTable zostaje skonstruowany obiekt WorkBook. Obiekt WorkBook jest używany do dodawania danych do arkusza Excel, który następnie można zapisać w innym miejscu. Kolejnym krokiem jest inicjalizacja obiektu WorkSheet, który jest powiązany z obiektem zeszytu.

Przed dodaniem wartości do arkusza używa się pętli foreach do odczytania każdej wartości z DataTable. Funkcja SaveAsCsv jest używana do zapisywania danych do pliku CSV, gdy wszystkie zostały umieszczone w arkuszu, używając nazwy pliku jako parametru. W razie potrzeby jako opcjonalny argument można użyć separatora. Biblioteka pomaga następnie w zapisywaniu danych do pliku CSV. Oprócz programu Microsoft Excel istnieje inny sposób odczytu plików CSV przy użyciu Notatnika. Również metoda Save jest używana do zapisywania tego samego w podanym formacie pliku.

WYNIK Plik Excel test.csv

Powyżej znajduje się wynik działania uruchomionego fragmentu kodu. Każda informacja z tabeli danych została osobno dodana do nowo utworzonego arkusza Excel widocznego na zrzucie ekranu. Alternatywnie można je również przekształcić w strumień w ramach aplikacji internetowej, aby zwrócić pliki, które można pobrać po stronie klienta.

Aby uzyskać więcej informacji na temat eksportowania danych z DataTable do Excela, zapoznaj się z tą stroną samouczka.

Aby dowiedzieć się więcej o eksportowaniu danych do programu Excel, zapoznaj się z tym samouczkiem krok po kroku.

5.0 Podsumowanie

IronXL jest jednym z najczęściej używanych narzędzi do obsługi programu Excel. Nie jest zależny od żadnych innych bibliotek zewnętrznych. Jest to samodzielna aplikacja i nie wymaga zainstalowanego programu Microsoft Excel. Ponadto działa on za pośrednictwem różnych kanałów.

W przypadku wszystkich operacji związanych z dokumentami Microsoft Excel realizowanych programowo, IronXL oferuje kompleksowe rozwiązanie. Możliwe jest obliczanie formuł, sortowanie ciągów znaków lub liczb, przycinanie, dołączanie, wyszukiwanie i zamiana, scałanie i rozdzielanie, zapisywanie plików i wiele więcej. Oprócz sprawdzania poprawności danych w arkuszu kalkulacyjnym można również określać typy danych komórek. Ułatwia to pracę z danymi programu Excel oraz umożliwia odczyt i zapis plików.

IronXL oferuje bezpłatną licencję próbną, która pozwala użytkownikom wypróbować i przetestować wszystkie jego niesamowite funkcje za darmo.

Przy uruchomieniu IronXL jest dostępny dla $999. Użytkownicy mogą również zdecydować się na opłacenie rocznej subskrypcji, aby otrzymywać aktualizacje i wsparcie techniczne dotyczące produktu. IronXL zapewnia bezpieczeństwo nieograniczonej redystrybucji za dodatkową opłatą. Aby uzyskać dokładniejsze informacje na temat cen, odwiedź stronę licencji IronXL.