如何在 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 參考資料