Importieren von Excel-Dateien in C#35;

IronXL macht den Excel-Import einfacher

Importieren Sie Daten mit den von der IronXL Excel-Bibliothek bereitgestellten Funktionen, die wir in diesem Tutorial verwenden werden. Die Software ist für die Entwicklung kostenlos verfügbar. IronXL bietet eine umfassende C# Excel API, die die Arbeit mit Excel-Dateien vereinfacht, ohne dass Microsoft Office oder Interop-Abhängigkeiten erforderlich sind. Dies macht sie ideal für Serverumgebungen und Cloud-Bereitstellungen.

Installationsmethoden

Installieren Sie in Ihr C#-Projekt über DLL-Download oder navigieren Sie mit dem NuGet-Paket. Eine ausführliche Anleitung zur Installation finden Sie in unserer Übersicht über die ersten Schritte.

Install-Package IronXL.Excel

Anleitung zum Tutorial

Basic WorkBook Loading Process

Für unser heutiges Projekt werden wir Excel-Daten in unsere C#-Anwendung importieren, indem wir die in Schritt 1 installierte IronXL-Software verwenden. Die Bibliothek unterstützt verschiedene Excel-Formate und bietet intuitive Methoden zum Laden von Tabellenkalkulationen.

In Schritt 2 laden wir unser Excel WorkBook in unser CSharp-Projekt, indem wir die Funktion WorkBook.Load() von IronXL. Wir übergeben den Pfad des Excel WorkBook als String-Parameter in dieser Funktion:

// Load Excel file
WorkBook wb = WorkBook.Load("Path");

// Load Excel file
WorkBook wb = WorkBook.Load("Path");

' Load Excel file
Dim wb As WorkBook = WorkBook.Load("Path")

Die Excel-Datei am angegebenen Pfad wird in wb geladen. Diese Methode unterstützt XLSX, XLS, CSV, TSV und andere gängige Tabellenkalkulationsformate.

Zugriff auf ein bestimmtes WorkSheet

Als Nächstes müssen wir auf ein bestimmtes Arbeitsblatt der Excel-Datei zugreifen, deren Daten ins Projekt importiert werden. Zu diesem Zweck können wir die GetWorkSheet()-Funktion von IronXL verwenden, wobei wir den Blattnamen als String-Parameter übergeben, um anzugeben, welches Blatt des Arbeitsbuchs importiert werden soll. Erfahren Sie mehr über die Verwaltung von Arbeitsblättern in unserem umfassenden Leitfaden.

// Specify sheet name of Excel WorkBook
WorkSheet ws = wb.GetWorkSheet("SheetName");

// Specify sheet name of Excel WorkBook
WorkSheet ws = wb.GetWorkSheet("SheetName");

' Specify sheet name of Excel WorkBook
Dim ws As WorkSheet = wb.GetWorkSheet("SheetName")

Das WorkSheet wird als ws importiert, und wb ist das WorkBook, das wir im obigen Codebeispiel definiert haben.

Alternative Methoden für den Zugriff auf WorkSheets

Es gibt die folgenden alternativen Möglichkeiten, ein Excel-Arbeitsblatt in das Projekt zu importieren. Jede Methode bietet Flexibilität in Abhängigkeit von Ihrem spezifischen Anwendungsfall:

// Import WorkSheet by various methods

// by sheet indexing
WorkSheet mySheet = wb.WorkSheets[SheetIndex];

// get default WorkSheet
WorkSheet defaultSheet = wb.DefaultWorkSheet;

// get first WorkSheet
WorkSheet firstSheet = wb.WorkSheets.First();

// for the first or default sheet
WorkSheet firstOrDefaultSheet = wb.WorkSheets.FirstOrDefault();

// Import WorkSheet by various methods

// by sheet indexing
WorkSheet mySheet = wb.WorkSheets[SheetIndex];

// get default WorkSheet
WorkSheet defaultSheet = wb.DefaultWorkSheet;

// get first WorkSheet
WorkSheet firstSheet = wb.WorkSheets.First();

// for the first or default sheet
WorkSheet firstOrDefaultSheet = wb.WorkSheets.FirstOrDefault();

' Import WorkSheet by various methods

' by sheet indexing
Dim mySheet As WorkSheet = wb.WorkSheets(SheetIndex)

' get default WorkSheet
Dim defaultSheet As WorkSheet = wb.DefaultWorkSheet

' get first WorkSheet
Dim firstSheet As WorkSheet = wb.WorkSheets.First()

' for the first or default sheet
Dim firstOrDefaultSheet As WorkSheet = wb.WorkSheets.FirstOrDefault()

Jetzt können wir problemlos jede Art von Daten aus den angegebenen Excel-Dateien importieren. Lassen Sie uns alle möglichen Aspekte für den Import von Excel-Dateien in unserem Projekt untersuchen.

Basic Cell Import Methode

Dies ist der grundlegende Aspekt des Imports von Excel-Dateidaten in unser Projekt. IronXL bietet mehrere Möglichkeiten, auf Zelldaten zuzugreifen, was es für verschiedene Szenarien flexibel macht.

Zu diesem Zweck können wir ein Zelladressierungssystem verwenden, um anzugeben, welche Zelldaten wir importieren müssen. Sie gibt den Wert einer bestimmten Zelladresse aus der Excel-Datei zurück:

var cellValue = ws["Cell Address"];

var cellValue = ws["Cell Address"];

Dim cellValue = ws("Cell Address")

Datenimport mit Zeilen- und Spaltenindizes

Wir können auch Zelldaten aus Excel-Dateien nach Zeilen- und Spaltenindex importieren. Diese Codezeile gibt den Wert des angegebenen Zeilen- und Spaltenindexes zurück. Dieser Ansatz ist besonders nützlich, wenn Daten programmatisch durchlaufen werden:

var cellValueByIndex = ws.Rows[RowIndex].Columns[ColumnIndex];

var cellValueByIndex = ws.Rows[RowIndex].Columns[ColumnIndex];

Dim cellValueByIndex = ws.Rows(RowIndex).Columns(ColumnIndex)

Speichern von importierten Werten in Variablen

Um importierte Zellwerte Variablen zuzuweisen, verwenden Sie diesen Code. Die Methode ToString() gewährleistet die Kompatibilität mit String-Variablen, aber Sie können bei Bedarf auch auf andere Typen casten:

// Import Data by Cell Address
// by cell addressing
string val = ws["Cell Address"].ToString();

// by row and column indexing
string valWithIndexing = ws.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();

// for numeric values
decimal numericValue = ws["B2"].DecimalValue;

// for date values
DateTime dateValue = ws["C2"].DateTimeValue;

// Import Data by Cell Address
// by cell addressing
string val = ws["Cell Address"].ToString();

// by row and column indexing
string valWithIndexing = ws.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();

// for numeric values
decimal numericValue = ws["B2"].DecimalValue;

// for date values
DateTime dateValue = ws["C2"].DateTimeValue;

IRON VB CONVERTER ERROR developers@ironsoftware.com

In den obigen Beispielen beginnt der Zeilen- und Spaltenindex bei 0. Weitere fortgeschrittene Zelloperationen finden Sie in unserem Leitfaden zum Löschen von Zellen und Kopieren von Zellen.

Syntax der Bereichsfunktionen

To import data in a specific range from an Excel WorkBook, use the range function. Definieren Sie den Bereich, indem Sie die Adressen der Anfangs- und Endzellen beschreiben. Dies gibt alle Zellwerte innerhalb des angegebenen Bereichs zurück. Umfassende Techniken zur Bereichsauswahl finden Sie in unserem Leitfaden zur Bereichsauswahl.

var rangeData = ws["Starting Cell Address:Ending Cell Address"];

var rangeData = ws["Starting Cell Address:Ending Cell Address"];

Dim rangeData = ws("Starting Cell Address:Ending Cell Address")

Komplettes Beispiel für den Bereichsimport

Weitere Informationen über die Arbeit mit Bereichen in Excel-Dateien und über das Abrufen von Daten mit verschiedenen Methoden. Das folgende Beispiel demonstriert den Import von einzelnen Zellwerten und Bereichen:

:path=/static-assets/excel/content-code-examples/how-to/csharp-import-excel-import.cs

using IronXL;
using System;

// Import Excel WorkBook
WorkBook wb = WorkBook.Load("sample.xlsx");

// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");

// Import data of specific cell
string val = ws["A4"].Value.ToString();
Console.WriteLine("Import Value of A4 Cell address: {0}", val);

Console.WriteLine("import Values in Range From B3 To B9 :\n");

// Import data in specific range
foreach (var item in ws["B3:B9"])
{
    Console.WriteLine(item.Value.ToString());
}

Console.ReadKey();

IRON VB CONVERTER ERROR developers@ironsoftware.com

Der obige Code zeigt die folgende Ausgabe an:

With the values of Excel file sample.xlsx as:

Verfügbare Aggregat-Funktionen

Wenden Sie Aggregatfunktionen auf Excel-Dateien an und importieren Sie die resultierenden Daten aus diesen Funktionen. IronXL bietet integrierte mathematische Funktionen, die die Datenanalyse vereinfachen. Hier sind Beispiele für verschiedene Funktionen und ihre Verwendung:

• Sum()

  // To find the sum of a specific cell range
  var sum = ws["Starting Cell Address:Ending Cell Address"].Sum();

  // To find the sum of a specific cell range
  var sum = ws["Starting Cell Address:Ending Cell Address"].Sum();

  ' To find the sum of a specific cell range
  Dim sum = ws("Starting Cell Address:Ending Cell Address").Sum()

  $vbLabelText   $csharpLabel

• Average()

  // To find the average of a specific cell range
  var average = ws["Starting Cell Address:Ending Cell Address"].Avg();

  // To find the average of a specific cell range
  var average = ws["Starting Cell Address:Ending Cell Address"].Avg();

  ' To find the average of a specific cell range
  Dim average = ws("Starting Cell Address:Ending Cell Address").Avg()

  $vbLabelText   $csharpLabel

• Min()

  // To find the minimum in a specific cell range
  var minimum = ws["Starting Cell Address:Ending Cell Address"].Min();

  // To find the minimum in a specific cell range
  var minimum = ws["Starting Cell Address:Ending Cell Address"].Min();

  ' To find the minimum in a specific cell range
  Dim minimum = ws("Starting Cell Address:Ending Cell Address").Min()

  $vbLabelText   $csharpLabel

• Max()

  // To find the maximum in a specific cell range
  var maximum = ws["Starting Cell Address:Ending Cell Address"].Max();

  // To find the maximum in a specific cell range
  var maximum = ws["Starting Cell Address:Ending Cell Address"].Max();

  ' To find the maximum in a specific cell range
  Dim maximum = ws("Starting Cell Address:Ending Cell Address").Max()

  $vbLabelText   $csharpLabel

Mehrere Aggregatfunktionen zusammen verwenden

Lesen Sie mehr über die Arbeit mit Aggregatfunktionen in Excel für C# und erfahren Sie mehr über das Ziehen von Daten mit verschiedenen Methoden. Diese Funktionen sind besonders nützlich, um zusammenfassende Statistiken zu erstellen oder importierte Daten zu validieren.

Sehen Sie sich ein Beispiel für den Import von Daten aus einer Excel-Datei an, indem Sie diese Funktionen anwenden:

:path=/static-assets/excel/content-code-examples/how-to/csharp-import-excel-math-functions.cs

using IronXL;
using System;

// Import Excel file
WorkBook wb = WorkBook.Load("sample.xlsx");

// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");

// Import Excel file data by applying aggregate functions
decimal sum = ws["D2:D9"].Sum();
decimal avg = ws["D2:D9"].Avg();
decimal min = ws["D2:D9"].Min();
decimal max = ws["D2:D9"].Max();

Console.WriteLine("Sum From D2 To D9: {0}", sum);
Console.WriteLine("Avg From D2 To D9: {0}", avg);
Console.WriteLine("Min From D2 To D9: {0}", min);
Console.WriteLine("Max From D2 To D9: {0}", max);

Console.ReadKey();

IRON VB CONVERTER ERROR developers@ironsoftware.com

Der obige Code gibt uns dieses Ergebnis:

Und unsere Datei Muster.xlsx enthält diese Werte:

Die ToDataSet-Methode

Um vollständige Daten aus einer Excel-Datei in ein C#-Projekt zu importieren, muss das geladene WorkBook zunächst in ein DataSet geparst werden. Auf diese Weise werden die kompletten Excel-Daten in das DataSet importiert, und Arbeitsblätter in Excel-Dateien werden zu Datentabellen innerhalb dieses DataSets. Dieser Ansatz ist besonders nützlich für Datenbankoperationen oder bei der Arbeit mit datengebundenen Steuerelementen. Erfahren Sie mehr über das Importieren und Exportieren als DataSet.

// Import WorkBook into DataSet
DataSet ds = wb.ToDataSet();

// Import WorkBook into DataSet
DataSet ds = wb.ToDataSet();

' Import WorkBook into DataSet
Dim ds As DataSet = wb.ToDataSet()

Dies importiert unser spezifiziertes WorkSheet in ein DataSet zur Verwendung gemäß den Anforderungen. Diese Methode ist besonders leistungsfähig, wenn mit mehreren Blättern gleichzeitig gearbeitet wird oder wenn Excel-Daten mit ADO.NET-Operationen integriert werden.

Behandlung von Spaltenüberschriften

Oft dient die erste Zeile einer Excel-Datei als Spaltenname. In diesem Fall machen Sie die erste Zeile zu DataTable-Spaltennamen. Setzen Sie den booleschen Parameter der ToDataSet()-Funktion von IronXL wie folgt:

// Import WorkBook into DataSet with first row as ColumnNames
DataSet ds = wb.ToDataSet(true);

// Import WorkBook into DataSet with first row as ColumnNames
DataSet ds = wb.ToDataSet(true);

' Import WorkBook into DataSet with first row as ColumnNames
Dim ds As DataSet = wb.ToDataSet(True)

Dadurch wird die erste Zeile der Excel-Datei zu DataTable-Spaltennamen, was für die Wahrung der Datenstrukturintegrität bei der Arbeit mit strukturierten Excel-Daten unerlässlich ist.

Komplettes Beispiel für den Import eines Datensatzes

Sehen Sie ein vollständiges Beispiel für den Import von Excel-Daten in ein DataSet und die Verwendung der ersten Zeile eines Excel-Arbeitsblatts als DataTable-Spaltennamen:

:path=/static-assets/excel/content-code-examples/how-to/csharp-import-excel-dataset.cs

using IronXL;
using System;
using System.Data;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");

// Import Excel data into a DataSet
DataSet ds = wb.ToDataSet(true);

Console.WriteLine("Excel file data imported to dataset successfully.");
Console.ReadKey();

IRON VB CONVERTER ERROR developers@ironsoftware.com

Die Arbeit mit Excel Dataset- und DataTable-Funktionen kann komplex sein, aber wir haben weitere Beispiele für die Einbindung von Dateidaten in Ihr C#-Projekt zur Verfügung. Für fortgeschrittene Szenarien empfehlen wir unsere Leitfäden zu Excel to SQL via DataTable und zum Laden von Excel aus einer SQL-Datenbank.

Bibliothek Schnellzugriff

Erkunden Sie die IronXL-Referenz

Erfahren Sie mehr über das Abrufen von Excel-Daten über Zellen, Bereiche, Datensätze und Datentabellen in unserer vollständigen Dokumentation API Reference for IronXL.

Erkunden Sie die IronXL-Referenz