僅從 Excel 檔案載入可見工作表

介紹

當您在 .NET 應用程式中使用 Excel 檔案時，管理多個工作表的挑戰就變得顯而易見，特別是當某些工作表隱藏或與您的操作無關時。 Aspose.Cells for .NET 是一個功能強大的程式庫，可協助您有效率地操作 Excel 檔案。在本文中，我們將探討如何僅載入 Excel 檔案中的可見工作表，過濾掉任何隱藏資料。如果您曾經因瀏覽 Excel 資料而感到不知所措，那麼本指南適合您！

先決條件

在深入本教程之前，我們先確保您擁有遵循本教程所需的一切：

  1. C# 的基本了解：本教學專為熟悉 C# 程式語言的開發人員而設計。
  2. Aspose.Cells for .NET：您必須下載並設定 Aspose.Cells for .NET 函式庫。你可以在這裡下載庫.
  3. Visual Studio 或任何 IDE：您應該有一個可以編寫和測試 C# 程式碼的 IDE。
  4. .NET Framework：請確保安裝了執行應用程式所需的 .NET Framework。
  5. 範例 Excel 檔案：為了練習，請建立一個範例 Excel 檔案或按照提供的程式碼進行操作。 一切都準備好了嗎？驚人的！讓我們開始吧！

導入包

使用 Aspose.Cells 的任何 C# 專案的第一步是導入所需的套件。這使您能夠存取該庫提供的所有功能。操作方法如下：

  1. 開啟您的專案：首先在 Visual Studio 或任何其他首選 IDE 中開啟您的 C# 專案。
  2. 新增參考：在解決方案資源管理器中右鍵單擊您的項目，選擇“新增”，然後選擇“引用”。
  3. 瀏覽 Aspose.Cells：找到您先前下載的 Aspose.Cells.dll 檔案並將其新增至您的專案參考。 此步驟至關重要，因為它將 Aspose.Cells 功能連結到您的專案。
using System.IO;
using Aspose.Cells;
using System;

現在您已經匯入了必要的套件，我們將建立一個範例 Excel 工作簿。在本工作簿中，我們將有多個工作表，其中一個工作表將在本教程中隱藏。

第 1 步：設定您的環境

首先，我們設定環境並指定範例文件的路徑。

//文檔目錄的路徑。
string dataDir = "Your Document Directory";
string sampleFile = "output.xlsx";
string samplePath = dataDir + sampleFile;

在此程式碼片段中，替換"Your Document Directory"與您要儲存工作簿的實際路徑。

第 2 步：建立工作簿

接下來，讓我們建立工作簿並添加一些資料。

//建立範例工作簿
Workbook createWorkbook = new Workbook();
createWorkbook.Worksheets["Sheet1"].Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets.Add("Sheet2").Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets.Add("Sheet3").Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets["Sheet3"].IsVisible = false; //隱藏 Sheet3
createWorkbook.Save(samplePath);

以下是所發生情況的詳細說明：

  • 我們正在建立一個新工作簿並新增三張工作表。
  • 「Sheet1」和「Sheet2」將可見，而「Sheet3」將隱藏。
  • 然後我們將工作簿儲存到指定的路徑。

步驟 3：使用載入選項載入範例工作簿

現在我們有了一個包含可見工作表和隱藏工作表的工作簿，是時候載入它，同時確保我們只存取可見工作表了。

LoadOptions loadOptions = new LoadOptions();
loadOptions.LoadFilter = new CustomLoad();

此程式碼片段設定工作簿的載入選項，我們將自訂該選項以過濾掉隱藏的工作表。

步驟 4：定義自訂負載過濾器

為了僅載入可見工作表，我們需要建立一個自訂載入篩選器。下面是如何定義它：

class CustomLoad : LoadFilter
{
    public override void StartSheet(Worksheet sheet)
    {
        if (sheet.IsVisible)
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.All;
        }
        else
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.Structure;
        }
    }
}
  • 這StartSheet方法檢查每張紙是否可見。
  • 如果它可見，則會載入該工作表中的所有資料。
  • 如果它不可見，它將跳過從該工作表載入任何資料。

步驟 5：使用載入選項載入工作簿

現在讓我們載入工作簿並顯示可見工作表中的資料。

Workbook loadWorkbook = new Workbook(samplePath, loadOptions);
Console.WriteLine("Sheet1: A1: {0}", loadWorkbook.Worksheets["Sheet1"].Cells["A1"].Value);
Console.WriteLine("Sheet2: A1: {0}", loadWorkbook.Worksheets["Sheet2"].Cells["A1"].Value);

該程式碼片段利用了loadOptions僅從可見工作表匯入資料並顯示「Sheet1」和「Sheet2」中儲存格 A1 的內容。

結論

現在你就擁有了！您已成功學習如何使用 Aspose.Cells for .NET 從 Excel 檔案中僅載入可見工作表。當您知道如何限制檢索的資料並僅使用您需要的資料時，管理 Excel 工作表就會變得輕而易舉。這不僅提高了應用程式的效率，還使您的程式碼更乾淨、更易於管理。

常見問題解答

如果需要，我可以加載隱藏的紙張嗎？

是的，您可以簡單地調整自訂負載過濾器中的條件以包含隱藏工作表。

Aspose.Cells 有何用途？

Aspose.Cells 用於操作 Excel 文件，無需安裝 Microsoft Excel，提供讀取、寫入和管理 Excel 工作表等功能。

Aspose.Cells 有試用版嗎？

是的，你可以下載免費試用版來測試它的功能。

在哪裡可以找到 Aspose.Cells 的文件？

這文件提供有關所有功能的全面資訊。

如何購買 Aspose.Cells？

您可以輕鬆地購買 Aspose.Cells從他們的購買頁面。

在 Excel 中保留空白行的分隔符