1. IronXL
  2. Poradniki
  3. C Sharp odczytuje plik XLSX

C# Odczyt pliku XLSX

Curtis Chau
Curtis Chau
Zaktualizowano:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Aby czytać pliki XLSX w C#, użyj metody WorkBook.Load w IronXL, aby otworzyć plik Excel i uzyskać dostęp do arkuszy kalkulacyjnych w celu odczytu danych komórek, wykonywania obliczeń i konwersji do formatu DataTable lub DataSet programistycznie.

Szybki start: Załaduj skoroszyt i uzyskaj dostęp do arkusza roboczego bez wysiłku

Dzięki IronXL możesz załadować plik XLSX używając metody WorkBook.Load w jednej linii. Następnie uzyskaj natychmiastowy dostęp do jego pierwszego lub nazwanego arkusza i rozpocznij czytanie wartości komórek.

  1. Install IronXL with NuGet Package Manager

    PM > Install-Package IronXL.Excel

  2. Skopiuj i uruchom ten fragment kodu.

    IronXL.WorkBook workbook = IronXL.WorkBook.Load("your-file.xlsx");

  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronXL w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Odczyt plików .XLSX C#

  • Pobierz IronXL dla swojego projektu
  • Załaduj WorkBook
  • Uzyskaj dostęp do danych z WorkSheet
  • Zastosuj funkcje takie jak Sum, Min i Max
  • Odczytaj WorkSheet jako DataTable, DataSet i inne
How To Work related to C# Odczyt pliku XLSX

Jak uzyskać IronXL dla mojego projektu?

Użyj IronXL w swoim projekcie jako prostego sposobu pracy z formatami plików Excel w C#. Można albo zainstalować IronXL przez bezpośrednie pobranie, albo można użyć NuGet Install for Visual Studio. Oprogramowanie jest darmowe do celów rozwojowych.

Install-Package IronXL.Excel

Przed przystąpieniem do odczytu plików XLSX, zapoznaj się z obszerną dokumentacją IronXL w celu zrozumienia wszystkich dostępnych funkcji. IronXL obsługuje zarówno formaty .xls, jak i .xlsx, co czyni go wszechstronnym dla plików Excel starszych i nowoczesnych.

Poradnik "Jak to zrobić"

Jak załadować WorkBook?

WorkBook to klasa IronXL, której obiekt zapewnia pełny dostęp do pliku Excel i wszystkich jego funkcji. Na przykład, aby uzyskać dostęp do pliku Excel, użyj kodu:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-load-workbook.cs
using IronXL;

// Load the workbook
WorkBook workBook = WorkBook.Load("sample.xlsx"); // Excel file path
Imports IronXL

' Load the workbook
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx") ' Excel file path
$vbLabelText   $csharpLabel

Dlaczego używać metody WorkBook.Load()?

W powyższym kodzie funkcja Load() załadowuje WorkBook do WorkBook. Każdy rodzaj funkcji może być wykonywany na WorkBook uzyskując dostęp do określonego WorkSheet pliku Excel. Metoda Load() automatycznie wykrywa format pliku, czy to XLS, XLSX, XLSM, XLTX czy CSV. Dla bardziej zaawansowanych scenariuszy ładowania, zapoznaj się z szczegółowym przewodnikiem po ładowaniu arkuszy kalkulacyjnych.

Jak uzyskać dostęp do określonego WorkSheet?

Aby uzyskać dostęp do określonego WorkSheet pliku Excel, IronXL oferuje klasę WorkBook. Można go stosować na kilka różnych sposobów:

Jakie są różne sposoby uzyskania dostępu do arkusza roboczego?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-worksheet.cs
using IronXL;

// Access sheet by name
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
Imports IronXL

' Access sheet by name
Dim workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")
$vbLabelText   $csharpLabel

WorkBook["SheetName"] to WorkSheet zadeklarowana w powyższej części.

LUB

WorkBook

LUB

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-worksheet-index.cs
using IronXL;

// Access sheet by index
WorkSheet workSheet = workBook.WorkSheets[0];
Imports IronXL

' Access sheet by index
Dim workSheet As WorkSheet = workBook.WorkSheets(0)
$vbLabelText   $csharpLabel

LUB

WorkBook.Load()

LUB

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-default-worksheet.cs
using IronXL;

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;
Imports IronXL

' Access the default worksheet
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
$vbLabelText   $csharpLabel

LUB

sample.xlsx

LUB

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-worksheet.cs
using IronXL;
using System.Linq;

// Access the first worksheet
WorkSheet workSheet = workBook.WorkSheets.First();
Imports IronXL
Imports System.Linq

' Access the first worksheet
Dim workSheet As WorkSheet = workBook.WorkSheets.First()
$vbLabelText   $csharpLabel

LUB

workBook

LUB

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-or-default-worksheet.cs
using IronXL;
using System.Linq;

// Access the first or default worksheet
WorkSheet workSheet = workBook.WorkSheets.FirstOrDefault();
Imports IronXL
Imports System.Linq

' Access the first or default worksheet
Dim workSheet As WorkSheet = workBook.WorkSheets.FirstOrDefault()
$vbLabelText   $csharpLabel

LUB

workBook

LUB

WorkBook.Load

LUB

WorkSheet

LUB

WorkSheet

LUB

workBook

LUB

WorkBook

Kiedy powinienem używać każdej metody dostępu do arkusza roboczego?

Każda metoda ma idealny przypadek użycia:

  • GetWorkSheet("name"): Kiedy znasz dokładną nazwę arkusza
  • WorkSheets[index]: Dla iteracji programistycznej przez arkusze
  • DefaultWorkSheet: Szybki dostęp przy pracy z plikami jednokartkowymi
  • First() lub FirstOrDefault(): Bezpieczne opcje, gdy nazwy arkuszy mogą się zmienić

Po uzyskaniu ExcelSheet workSheet, możesz uzyskać dowolny rodzaj danych z niego i wykonać wszystkie funkcje Excel na nim. Więcej złożonych operacji na arkuszach roboczych znajdziesz w przewodniku na temat otwierania arkuszy Excel w C#.

Jak uzyskiwać dostęp do danych z WorkSheet?

Dane można uzyskać z ExcelSheet workSheet w tym procesie:

Jakie typy danych mogę odczytać z komórek?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-data.cs
using IronXL;

// Accessing data as a string
string dataString = workSheet["A1"].ToString();

// Accessing data as an integer
int dataInt = workSheet["B1"].Int32Value;
Imports IronXL

' Accessing data as a string
Dim dataString As String = workSheet("A1").ToString()

' Accessing data as an integer
Dim dataInt As Integer = workSheet("B1").Int32Value
$vbLabelText   $csharpLabel

IronXL zapewnia różne akcesory wartości dla różnych typów danych:

  • StringValue: Dla danych tekstowych
  • Int32Value: Dla liczb całkowitych
  • DoubleValue: Dla liczb dziesiętnych
  • DateTimeValue: For dates
  • BoolValue: Dla wartości true/false

Jak odczytywać wiele komórek naraz?

Możesz również uzyskać dane z wielu komórek określonej kolumny:

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}
foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}
For Each cell In workSheet("A2:A10")
	Console.WriteLine("Value is: {0}", cell.Text)
Next cell
$vbLabelText   $csharpLabel

To wyświetla wartości od komórki A2 do A10. Dla bardziej zaawansowanych technik wyboru zakresu, odwiedź samouczek wyboru zakresu.

Jak wygląda pełna implementacja?

Pełny przykład kodu dla powyższych specyfik następuje tutaj:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-log-data.cs
using IronXL;
using System;

// Load an Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Specify the range
foreach (var cell in workSheet["B2:B10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}
Imports IronXL
Imports System

' Load an Excel file
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")
Dim workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Specify the range
For Each cell In workSheet("B2:B10")
    Console.WriteLine("Value is: {0}", cell.Text)
Next
$vbLabelText   $csharpLabel

Pokazuje następujący wynik:

Wynik konsoli pokazujący wyodrębnione dane z arkusza roboczego z wartościami Rządowe, Prywatne, Średni rynek i Partnerzy kanałowi

Z plikiem Excel Sample.xlsx:

Arkusz kalkulacyjny Excel z danymi biznesowymi pokazujący kolumny Segment, Kraj, Produkt i Pasmo zniżek na 16 rzędach

Te metody pokazują, jak bezwysiłkowo można używać danych z pliku Excel w projekcie. Dla praktycznych przykładów odczytu plików Excel bez Interop, zapoznaj się z przykładami odczytu Excela.

Jak mogę wykonywać funkcje na danych?

Uzyskaj dostęp do przefiltrowanych danych z WorkSheet Excel, stosując funkcje agregujące takie jak Sum, Min lub Max przy użyciu poniższego kodu:

Jakie funkcje agregacyjne są dostępne?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-aggregate-function.cs
using IronXL;

// Apply aggregate functions
decimal sum = workSheet["G2:G10"].Sum(); // Sum of cells from G2 to G10
decimal min = workSheet["G2:G10"].Min(); // Minimum value in cells from G2 to G10
decimal max = workSheet["G2:G10"].Max(); // Maximum value in cells from G2 to G10
Imports IronXL

' Apply aggregate functions
Dim sum As Decimal = workSheet("G2:G10").Sum() ' Sum of cells from G2 to G10
Dim min As Decimal = workSheet("G2:G10").Min() ' Minimum value in cells from G2 to G10
Dim max As Decimal = workSheet("G2:G10").Max() ' Maximum value in cells from G2 to G10
$vbLabelText   $csharpLabel

IronXL wspiera liczne funkcje matematyczne w tym:

  • Average(): Oblicz średnią wartość
  • Count(): Zlicz niepuste komórki
  • CountIf(): Zlicz komórki spełniające kryteria
  • Median(): Znajdź wartość środkową
  • StdDev(): Oblicz odchylenie standardowe

Jak wdrożyć wiele funkcji razem?

Dla większej ilości szczegółów, sprawdź nasz dogłębny samouczek na temat Jak Zapisać pliki Excel w C# ze szczegółami dotyczącymi funkcji agregacyjnych. Możesz również zapoznać się z pełną listą funkcji matematycznych dostępnych w IronXL.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-min-max.cs
using IronXL;
using System;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Calculate sum, minimum, and maximum for a range of cells
decimal sum = workSheet["G2:G10"].Sum();
decimal min = workSheet["G2:G10"].Min();
decimal max = workSheet["G2:G10"].Max();

// Output results
Console.WriteLine("Sum is: {0}", sum);
Console.WriteLine("Min is: {0}", min);
Console.WriteLine("Max is: {0}", max);
Imports IronXL
Imports System

' Load the Excel workbook
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Get the specified WorkSheet
Dim workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Calculate sum, minimum, and maximum for a range of cells
Dim sum As Decimal = workSheet("G2:G10").Sum()
Dim min As Decimal = workSheet("G2:G10").Min()
Dim max As Decimal = workSheet("G2:G10").Max()

' Output results
Console.WriteLine("Sum is: {0}", sum)
Console.WriteLine("Min is: {0}", min)
Console.WriteLine("Max is: {0}", max)
$vbLabelText   $csharpLabel

Ten kod wyświetla następujący wynik:

Terminal pokazujący wyniki analizy danych: Suma=482, Min=12, Max=350 na czarnym tle

I tak wygląda plik Excel Sample.xlsx:

Arkusz kalkulacyjny Excel z danymi sprzedażowymi pokazujący segmenty, kraje, produkty, sprzedane jednostki i ceny na wielu rzędach

Jak odczytywać WorkSheet Excel jako DataTable?

Używając IronXL, łatwo jest pracować z WorkSheet Excel jako DataTable. Ta funkcja jest szczególnie użyteczna, gdy trzeba zintegrować dane z Excela z istniejącymi systemami przetwarzania danych lub związać dane z kontrolkami interfejsu użytkownika.

Jaka jest podstawowa metoda konwersji?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable.cs
using IronXL;
using System.Data;

// Convert worksheet to DataTable
DataTable dt = workSheet.ToDataTable();
Imports IronXL
Imports System.Data

' Convert worksheet to DataTable
Dim dt As DataTable = workSheet.ToDataTable()
$vbLabelText   $csharpLabel

Jak użyć pierwszego wiersza jako nagłówków kolumn?

Aby użyć pierwszego wiersza ExcelSheet jako DataTable ColumnName:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable-header.cs
using IronXL;
using System.Data;

// Convert worksheet to DataTable with the first row as column names
DataTable dt = workSheet.ToDataTable(true);
Imports IronXL
Imports System.Data

' Convert worksheet to DataTable with the first row as column names
Dim dt As DataTable = workSheet.ToDataTable(True)
$vbLabelText   $csharpLabel

Parametr typu Boolean metody ToDataTable() ustawia pierwszy wiersz jako nazwy kolumn dla twojej DataTable. Domyślnie jego wartość to False. Jest to szczególnie przydatne, gdy pracuje się z danymi uporządkowanymi, które zawierają nagłówki.

Jak przeprowadzić iterację przez DataTable?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-print-datatable.cs
using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Convert WorkSheet to DataTable
DataTable dt = workSheet.ToDataTable(true); // Use first row as column names

// Iterate through rows and columns and display data
foreach (DataRow row in dt.Rows) // Access rows
{
    for (int i = 0; i < dt.Columns.Count; i++) // Access columns of corresponding row
    {
        Console.Write(row[i] + " ");
    }
    Console.WriteLine();
}
Imports IronXL
Imports System
Imports System.Data

' Load the Excel workbook
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Get the specified WorkSheet
Dim workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Convert WorkSheet to DataTable
Dim dt As DataTable = workSheet.ToDataTable(True) ' Use first row as column names

' Iterate through rows and columns and display data
For Each row As DataRow In dt.Rows ' Access rows
    For i As Integer = 0 To dt.Columns.Count - 1 ' Access columns of corresponding row
        Console.Write(row(i) & " ")
    Next
    Console.WriteLine()
Next
$vbLabelText   $csharpLabel

Korzystając z powyższego kodu, każda wartość komórki WorkSheet może być dostępna i użyta w miarę potrzeb. Dla bardziej zaawansowanych operacji DataTable, zobacz przewodnik dotyczący importowania i eksportowania jako DataSet.

Jak odczytywać plik Excel jako DataSet?

IronXL zapewnia prostą funkcję używania kompletnego pliku Excel (WorkBook) jako DataSet. Użyj metody ToDataSet, aby zamienić cały skoroszyt na DataSet.
W tym przykładzie zobaczymy, jak używać pliku Excel jako DataSet.

Jak przekonwertować workbook na DataSet?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-excel-to-dataset.cs
using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Convert the WorkBook to a DataSet
DataSet ds = workBook.ToDataSet();

// Iterate through tables in the DataSet and display table names
foreach (DataTable dt in ds.Tables)
{
    Console.WriteLine(dt.TableName);
}
Imports IronXL
Imports System
Imports System.Data

' Load the Excel workbook
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Convert the WorkBook to a DataSet
Dim ds As DataSet = workBook.ToDataSet()

' Iterate through tables in the DataSet and display table names
For Each dt As DataTable In ds.Tables
    Console.WriteLine(dt.TableName)
Next
$vbLabelText   $csharpLabel

Wynik powyższego kodu wygląda tak:

Uszkodzony lub niekompletny zrzut ekranu pokazujący tylko etykiety Sheet1, Sheet2, Sheet3

I tak wygląda plik Excel Sample.xlsx:

(center content omitted for brevity)

Jak uzyskać dostęp do każdej wartości komórki we wszystkich arkuszach?

W powyższym przykładzie możemy łatwo parsować plik Excel na DataSet i pracować z każdym DataTable pliku Excel jako DataTable. Zapoznaj się głębiej z tym jak analizować Excel jako DataSet tutaj, zawierając przykłady kodu.

Przyjrzyjmy się jeszcze jednemu przykładowi, jak uzyskać dostęp do wartości każdej komórki wszystkich ExcelSheets. Tutaj możemy uzyskać dostęp do wartości każdej komórki każdego ExcelSheet pliku Excel.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-all-excel-sheets.cs
using IronXL;
using System;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Iterate through every WorkSheet in the WorkBook
foreach (WorkSheet workSheet in workBook.WorkSheets)
{
    Console.WriteLine($"Worksheet: {workSheet.Name}");

    // Access each filled cell value on the current WorkSheet
    foreach (var cell in workSheet.FilledCells)
    {
        Console.WriteLine($"{cell.Address}: {cell.Text}");
    }
}

Imports IronXL
Imports System

' Load the Excel workbook
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Iterate through every WorkSheet in the WorkBook
For Each workSheet As WorkSheet In workBook.WorkSheets
    Console.WriteLine($"Worksheet: {workSheet.Name}")

    ' Access each filled cell value on the current WorkSheet
    For Each cell In workSheet.FilledCells
        Console.WriteLine($"{cell.Address}: {cell.Text}")
    Next
Next
$vbLabelText   $csharpLabel

Używając powyższego przykładu, można wygodnie uzyskać dostęp do wartości każdej komórki każdego ExcelSheet pliku Excel. To podejście jest szczególnie użyteczne przy pracy z książkami wieloarkuszowymi, gdzie dane są rozproszone na różnych kartach.

Więcej na temat tego, jak czytać pliki Excel bez Interop znajdziesz tutaj. Dokumentacja API referencyjnego dostarcza szczegółowe informacje o wszystkich dostępnych metodach i właściwościach w IronXL API Reference.

Szybki dostęp do samouczka

Referencja API dla IronXL

Przeczytaj więcej o funkcjach, klasach, polach metod, przestrzeniach nazw i wyliczeniach IronXL w dokumentacji.

Referencja API dla IronXL
Documentation related to Szybki dostęp do samouczka

WorkSheet

WorkSheet

WorkSheet

Często Zadawane Pytania

Jak odczytać pliki XLSX w języku C#?

Aby odczytać pliki XLSX w C#, użyj metody WorkBook.Load z IronXL. Po prostu załaduj plik Excel za pomocą IronXL.WorkBook.Load("twoj-plik.xlsx"), następnie uzyskaj dostęp do arkuszy, aby odczytywać dane komórek, wykonywać obliczenia i konwertować do formatu DataTable lub DataSet programowo.

Jakie formaty plików są obsługiwane podczas ładowania plików Excel?

IronXL obsługuje wiele formatów plików Excel, w tym .xls, .xlsx, .xlsm, .xltx i .csv. Metoda WorkBook.Load automatycznie wykrywa format pliku, co czyni ją wszechstronną zarówno dla starszych, jak i nowych plików Excel.

Jak mogę zainstalować bibliotekę do odczytywania Excel dla mojego projektu C#?

Możesz zainstalować IronXL zarówno poprzez bezpośrednie pobieranie, jak i przez NuGet Install dla Visual Studio. Oprogramowanie jest bezpłatne do celów deweloperskich i zapewnia prosty sposób pracy z formatami plików Excel w C#.

Jakie są różne sposoby uzyskania dostępu do konkretnego arkusza kalkulacyjnego?

IronXL oferuje wiele sposobów dostępu do arkuszy: możesz użyć workBook.GetWorkSheet("SheetName") do dostępu po nazwie, workBook.WorkSheets[0] do dostępu po indeksie lub workBook.WorkSheets.First() do pierwszego arkusza.

Czy mogę wykonywać obliczenia na danych Excel po ich załadowaniu?

Tak, po załadowaniu pliku XLSX z IronXL, możesz stosować różne funkcje, takie jak Sum, Min i Max na danych. Biblioteka zapewnia pełny dostęp do funkcjonalności plików Excel za pomocą obiektu WorkBook.

Czy możliwa jest konwersja danych z arkusza Excel na inne formaty?

Tak, IronXL pozwala na odczyt WorkSheet i konwersję do różnych formatów, w tym DataTable, DataSet i innych. To umożliwia łatwą integrację danych Excel z aplikacjami C#.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 2,150,290 | Wersja: 2026.7 właśnie wydany
Still Scrolling Icon

Wciąż przewijasz?

Chcesz szybkiego dowodu? PM > Install-Package IronXL.Excel
uruchom próbkę zobacz, jak Twoje dane stają się arkuszem.