如何在 C# 中导入 Excel 文件

1. 使用 IronXL 库导入数据

本教程将使用 IronXL Excel 库提供的函数导入数据。 该软件可免费用于开发。

通过 DLL 下载或使用 NuGet 包导航将其安装到您的C# 项目中。

Install-Package IronXL.Excel

如何使用教程

2. 项目访问工作表

为了满足我们今天的项目需求，我们将使用在步骤 1 中安装的 IronXL 软件，将 Excel 数据导入到我们的 C# 应用程序中。

在步骤 2 中，我们将使用 IronXL 的WorkBook.Load()函数将 Excel 工作簿加载到我们的 C# 项目中。 在这个函数中，我们将 Excel 工作簿的路径作为字符串参数传递，如下所示：

// 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")

指定路径下的 Excel 文件将被加载到wb中。

接下来，我们需要访问 Excel 文件中的特定工作表，该文件中的数据将被导入到项目中。 为此，我们可以使用 IronXL 的GetWorkSheet()函数，将工作表名称作为字符串参数传递，以指定要导入 WorkBook 中的哪个工作表。

// 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")

工作表将以ws形式导入，而wb是我们在上面的代码示例中定义的工作簿。

还有以下几种将 Excel 工作表导入到项目中的替代方法。

// 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()

现在，我们可以轻松地从指定的 Excel 文件中导入任何类型的数据。 让我们来看看在项目中导入 Excel 文件数据的所有可能方法。

3. 在 C# 中导入 Excel 数据

这是将 Excel 文件数据导入我们项目的基本步骤。

为此，我们可以使用单元寻址系统来指定我们需要导入哪些单元数据。 它将返回Excel文件中特定单元格地址的值。

var cellValue = ws["Cell Address"];

var cellValue = ws["Cell Address"];

Dim cellValue = ws("Cell Address")

我们还可以使用行索引和列索引从 Excel 文件导入单元格数据。 这行代码将返回指定行和列索引的值。

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

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

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

如果我们想将导入的单元格值赋给变量，可以使用以下代码。

// 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();

// 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();

' Import Data by Cell Address
' by cell addressing
Dim val As String = ws("Cell Address").ToString()

' by row and column indexing
Dim valWithIndexing As String = ws.Rows(RowIndex).Columns(ColumnIndex).Value.ToString()

在以上示例中，行索引和列索引均从 0 开始。

4. 导入特定范围的 Excel 数据

如果要从 Excel 工作簿中导入特定范围内的数据，可以使用range函数轻松完成。 为了定义范围，我们需要描述起始单元格地址和结束单元格地址。 这样，它将返回指定范围内的所有单元格值。

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")

有关在 Excel 文件中处理范围的更多信息，请查看提供的代码示例。

: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

上述代码显示以下输出：

Excel 文件sample.xlsx中的值如下：

5. 通过聚合函数导入Excel数据

我们还可以将聚合函数应用于 Excel 文件，并导入这些聚合函数生成的结果数据。 以下是一些不同功能及其使用方法的示例。

• 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

您可以阅读更多关于在 Excel for C# 中使用聚合函数的内容，并了解更多关于使用不同方法提取数据的内容。

让我们来看一个应用这些函数导入 Excel 文件数据的例子。

: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

上述代码会输出以下结果：

我们的文件sample.xlsx将包含以下值：

6. 导入完整的Excel文件数据

如果我们想将完整的 Excel 文件数据导入到我们的 C# 项目中，我们可以先将加载的工作簿解析为数据集。 这样，完整的 Excel 数据将被导入到数据集中，Excel 文件中的工作表将成为该数据集中的数据表。 以下是实际应用示例：

// 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()

这样，我们指定的工作表将被导入到数据集中，我们可以根据需要使用该数据集。

通常，Excel 文件的第一列用作ColumnName 。 在这种情况下，我们需要将第一列设为 DataTable ColumnName 。 为此，我们将 IronXL 的ToDataSet()函数的布尔参数设置如下：

// 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)

这将把 Excel 文件的第一列设置为 DataTable ColumnName 。

让我们来看一个完整的示例，了解如何将 Excel 数据导入到数据集中，并将 Excel 工作表的第一列用作数据表ColumnName ：

: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

使用 Excel 数据集和数据表函数可能比较复杂，但我们提供了更多示例，帮助您将文件数据集成到 C# 项目中。

图书馆快速访问

查阅 IronXL 参考资料

在我们的 IronXL 完整文档 API 参考中，了解更多关于通过单元格、区域、数据集和数据表提取 Excel 数据的信息。

查阅 IronXL 参考资料