Funkcje biblioteki IronXL

Korzystając z biblioteki IronXL w języku C#, można łatwo odczytywać i konwertować dokumenty Microsoft Excel do plików CSV. Biblioteka IronXL to samodzielna biblioteka oprogramowania .NET, która może odczytywać różne formaty arkuszy kalkulacyjnych bez konieczności instalacji programu Microsoft Excel lub korzystania z interfejsu Microsoft Office Interop Excel.

IronXL to jedna z wiodących bibliotek arkuszy kalkulacyjnych Excel dla języka C#, kompatybilna zarówno z .NET Core, jak i .NET Framework. Obsługuje różne platformy .NET Framework, w tym aplikacje internetowe, aplikacje Windows Forms oraz aplikacje konsolowe. Odczytywanie plików Excel jest szybkie i proste dzięki IronXL. Obsługuje szeroki zakres formatów plików Excel, w tym XLSX, XLS, CSV, TSV, XLST, XLSM i inne. Można importować, edytować i eksportować tabele danych, eksportować zbiory danych oraz wykonywać wiele innych operacji. Możliwe jest również eksportowanie i zapisywanie plików o różnych rozszerzeniach.

Dzięki intuicyjnemu interfejsowi API C# biblioteki IronXL można bez wysiłku odczytywać, modyfikować i tworzyć pliki arkuszy kalkulacyjnych Excel w środowisku .NET. Zapewnia kompleksową obsługę platform .NET Core, .NET Framework, Xamarin, Mobile, Linux, macOS oraz Azure.

IronXL może wykonywać obliczenia podobnie jak Microsoft Excel i obsługuje kilka formatów danych w kolumnach, takich jak tekst, liczby całkowite, formuły, daty, waluty i wartości procentowe.

Aby dowiedzieć się więcej, kliknij na stronę internetową IronXL.

Tworzenie nowego projektu w Visual Studio

Przed użyciem frameworka IronXL należy utworzyć projekt .NET w programie Visual Studio. Działa z każdą wersją Visual Studio; zaleca się jednak korzystanie z najnowszej wersji. W zależności od wymagań można tworzyć różne szablony projektów lub aplikacje podobne do Windows Forms. W tym samouczku, aby uprościć sprawę, wykorzystamy aplikację Windows Forms.

Utwórz nowy projekt w Visual Studio

Po wybraniu szablonu projektu podaj nazwę i lokalizację projektu.

Skonfiguruj projekt

Następnie wybierz następującą strukturę. W projekcie tym zostanie wykorzystana platforma .NET Framework 4.7.

Wybór platformy .NET Framework

Po wygenerowaniu plików projektu można otworzyć plik Form1.cs w widoku projektanta, aby wstawić kod programu, zaprojektować interfejs i zbudować/uruchomić program. Następnie należy pobrać bibliotekę IronXL wymaganą dla tego rozwiązania. Pakiet można pobrać, używając następującego polecenia w menedżerze pakietów:

Install-Package IronXL.Excel

Zainstaluj pakiet IronXL w konsoli menedżera pakietów

Alternatywnie można użyć menedżera pakietów NuGet, aby wyszukać i pobrać pakiet "IronXL". Menedżer pakietów NuGet zapewnia wygodny sposób zarządzania zależnościami w projekcie.

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

Dla tego formularza, kontrolka DataGridView jest umieszczona na formularzu, aby załadować potrzebny plik Excel do kontrolki DataGridView.

Ładowanie danych z pliku Excel

Biblioteka IronXL to potężna biblioteka dla programu Excel, która pozwala odczytywać pliki Excel za pomocą zaledwie kilku linii kodu. Poniżej znajduje się przykład fragmentu kodu, który demonstruje, jak zaimportować dane Excel do DataGridView:

using System;
using System.Windows.Forms;
using IronXL;

namespace DataTableWindowsForm
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            string importFilePath = string.Empty;

            openFileDialog1.Filter = "Excel (*.xlsx)|*.xlsx";
            DialogResult result = openFileDialog1.ShowDialog();

            // Check if the user selected a file
            if (result == DialogResult.OK)
            {
                importFilePath = openFileDialog1.FileName;
            }
            
            // Proceed if the file path is not empty
            if (!string.IsNullOrEmpty(importFilePath))
            {
                // Load the Excel document
                WorkBook excelDoc = WorkBook.Load(importFilePath);
                
                // Convert the first sheet to a DataTable
                var dataTable = excelDoc.WorkSheets[0].ToDataTable();

                // Set the DataSource of dataGridView1 to the DataTable
                dataGridView1.DataSource = dataTable;
            }
        }
    }
}

using System;
using System.Windows.Forms;
using IronXL;

namespace DataTableWindowsForm
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            string importFilePath = string.Empty;

            openFileDialog1.Filter = "Excel (*.xlsx)|*.xlsx";
            DialogResult result = openFileDialog1.ShowDialog();

            // Check if the user selected a file
            if (result == DialogResult.OK)
            {
                importFilePath = openFileDialog1.FileName;
            }
            
            // Proceed if the file path is not empty
            if (!string.IsNullOrEmpty(importFilePath))
            {
                // Load the Excel document
                WorkBook excelDoc = WorkBook.Load(importFilePath);
                
                // Convert the first sheet to a DataTable
                var dataTable = excelDoc.WorkSheets[0].ToDataTable();

                // Set the DataSource of dataGridView1 to the DataTable
                dataGridView1.DataSource = dataTable;
            }
        }
    }
}

Imports System
Imports System.Windows.Forms
Imports IronXL

Namespace DataTableWindowsForm
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
            Dim importFilePath As String = String.Empty

            openFileDialog1.Filter = "Excel (*.xlsx)|*.xlsx"
            Dim result As DialogResult = openFileDialog1.ShowDialog()

            ' Check if the user selected a file
            If result = DialogResult.OK Then
                importFilePath = openFileDialog1.FileName
            End If
            
            ' Proceed if the file path is not empty
            If Not String.IsNullOrEmpty(importFilePath) Then
                ' Load the Excel document
                Dim excelDoc As WorkBook = WorkBook.Load(importFilePath)
                
                ' Convert the first sheet to a DataTable
                Dim dataTable = excelDoc.WorkSheets(0).ToDataTable()

                ' Set the DataSource of dataGridView1 to the DataTable
                dataGridView1.DataSource = dataTable
            End If
        End Sub
    End Class
End Namespace

Imports System
Imports System.Windows.Forms
Imports IronXL

Namespace DataTableWindowsForm
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
            Dim importFilePath As String = String.Empty

            openFileDialog1.Filter = "Excel (*.xlsx)|*.xlsx"
            Dim result As DialogResult = openFileDialog1.ShowDialog()

            ' Check if the user selected a file
            If result = DialogResult.OK Then
                importFilePath = openFileDialog1.FileName
            End If
            
            ' Proceed if the file path is not empty
            If Not String.IsNullOrEmpty(importFilePath) Then
                ' Load the Excel document
                Dim excelDoc As WorkBook = WorkBook.Load(importFilePath)
                
                ' Convert the first sheet to a DataTable
                Dim dataTable = excelDoc.WorkSheets(0).ToDataTable()

                ' Set the DataSource of dataGridView1 to the DataTable
                dataGridView1.DataSource = dataTable
            End If
        End Sub
    End Class
End Namespace

Powyższy kod importuje dane z programu Excel. Aby podać więcej kontekstu, załóżmy, że projektujemy aplikację Windows Forms z kontrolką DataGridView i przyciskiem. Przycisk otworzy okno dialogowe, w którym można wyszukać plik Excel w określonej lokalizacji. Dodano niestandardowy kod, aby filtrować i wyświetlać tylko ograniczoną liczbę plików o określonym rozszerzeniu.

Otwórz okno dialogowe, aby wybrać plik Excel

Następnie używana jest metoda Load do załadowania danych z pliku Excel. Metoda ta pozwala na załadowanie danych z różnych źródeł, takich jak nazwy plików, bajty czy strumienie. Jeśli plik Excel jest chroniony hasłem, można również przekazać hasło jako parametr.

Gdy szczegóły Excela zostaną załadowane do obiektu IronXL, używana jest metoda ToDataTable do przekonwertowania danych arkusza Excel na DataTable. Każdy arkusz w pliku Excel zostanie przekształcony w oddzielną tabelę.

Następnie należy załadować wymaganą tabelę z zestawu danych do DataGridView. W tym celu właściwość DataSource kontrolki DataGridView jest ustawiana na nowo utworzony obiekt DataTable z IronXL. Ten krok pozwala na wypełnienie danych z pliku Excel do DataGridView.

Wyświetl dane z pliku Excel

Dodatkowo, może być konieczna konfiguracja DataGridView, aby prawidłowo wyświetlał nagłówki i pierwszy wiersz danych, w zależności od konkretnych wymagań.

Aby uzyskać więcej samouczków dotyczących korzystania z IronXL, kliknij ten przewodnik.

Wnioski

IronXL to bardzo popularne narzędzie do obsługi programu Excel, które nie opiera się na zewnętrznych bibliotekach. Jest to niezależne rozwiązanie i nie wymaga instalacji programu Microsoft Excel. Jest kompatybilny z różnymi platformami.

Dzięki IronXL można programowo wykonywać szeroki zakres operacji związanych z dokumentami Microsoft Excel. Możesz wykonywać takie zadania, jak sortowanie ciągów znaków lub liczb, przycinanie i dodawanie danych, wyszukiwanie i zamiana wartości, scałanie i rozdzielanie komórek, zapisywanie plików i wiele innych. Pozwala również na walidację danych w arkuszach kalkulacyjnych oraz definiowanie typów danych komórek. Ponadto IronXL obsługuje odczyt i zapis plików CSV.

IronXL jest dostępny w sprzedaży z różnymi opcjami licencyjnymi. Klienci mają również możliwość opłacenia rocznej opłaty członkowskiej w celu uzyskania dostępu do aktualizacji i wsparcia technicznego. Za dodatkową opłatą IronXL zapewnia nieograniczone prawa do redystrybucji. Aby uzyskać bardziej szczegółowe informacje na temat cen, można odwiedzić stronę poświęconą licencjom.