使用 ICellsDataTableDataSource 進行工作簿設計器

介紹

透過自動資料整合來建立高級電子表格可以改變遊戲規則，尤其是在業務應用程式中。在本教程中，我們將深入探討如何使用ICellsDataTableDataSource適用於 Aspose.Cells for .NET 中的工作簿設計器。我們將引導您建立一個簡單的、人類可讀的解決方案，以將自訂資料動態載入到 Excel 檔案中。因此，如果您正在處理客戶名單、銷售數據或類似數據，那麼本指南非常適合您！

先決條件

首先，請確保您具備以下條件：

Aspose.Cells for .NET 函式庫 – 您可以從下列位置下載它這裡或取得免費試用版。
.NET 開發環境 – Visual Studio 是不錯的選擇。
對 C# 的基本了解 – 熟悉類別和資料處理將有助於您跟進。在繼續之前，請確保您的開發環境已設定必要的軟體包。

導入包

為了有效地使用Aspose.Cells，您需要匯入必要的套件。以下是所需命名空間的快速參考：

using Aspose.Cells.Rendering;
using Aspose.Cells.WebExtensions;
using System;
using System.Collections;

第 1 步：定義客戶資料類

首先，創建一個簡單的Customer班級。此類將包含基本的客戶詳細信息，例如FullName和Address。將其視為定義資料“形狀”的一種方法。

public class Customer
{
    public Customer(string aFullName, string anAddress)
    {
        FullName = aFullName;
        Address = anAddress;
    }
    public string FullName { get; set; }
    public string Address { get; set; }
}

第 2 步：設定客戶清單類

接下來，定義一個CustomerList擴展的類ArrayList。這個自訂清單將包含以下實例Customer並允許對每個條目進行索引存取。

public class CustomerList : ArrayList
{
    public new Customer this[int index]
    {
        get { return (Customer)base[index]; }
        set { base[index] = value; }
    }
}

在此步驟中，我們將資料包裝成 Aspose.Cells 可以識別和處理的格式。

步驟 3：建立客戶資料來源類

這就是事情變得有趣的地方。我們將創建一個CustomerDataSource類別實現ICellsDataTable使我們的資料與 Aspose.Cells 的工作簿設計器相容。

public class CustomerDataSource : ICellsDataTable
{
    internal string[] m_Columns;
    internal ICollection m_DataSource;
    private Hashtable m_PropHash;
    private IEnumerator m_IEnumerator;
    private PropertyInfo[] m_Properties;
    public CustomerDataSource(CustomerList customers)
    {
        this.m_DataSource = customers;
        this.m_Properties = customers[0].GetType().GetProperties();
        this.m_Columns = new string[this.m_Properties.Length];
        this.m_PropHash = new Hashtable(this.m_Properties.Length);
        for (int i = 0; i < m_Properties.Length; i++)
        {
            this.m_Columns[i] = m_Properties[i].Name;
            this.m_PropHash.Add(m_Properties[i].Name, m_Properties[i]);
        }
        this.m_IEnumerator = this.m_DataSource.GetEnumerator();
    }
    public string[] Columns => this.m_Columns;
    public int Count => this.m_DataSource.Count;
    public void BeforeFirst()
    {
        this.m_IEnumerator = this.m_DataSource.GetEnumerator();
    }
    public object this[int index] => this.m_Properties[index].GetValue(this.m_IEnumerator.Current, null);
    public object this[string columnName] => ((PropertyInfo)this.m_PropHash[columnName]).GetValue(this.m_IEnumerator.Current, null);
    public bool Next()
    {
        if (this.m_IEnumerator == null)
            return false;
        return this.m_IEnumerator.MoveNext();
    }
}

這個習俗CustomerDataSource類別使得 Aspose.Cells 能夠解釋每個Customer物件作為 Excel 文件中的一行。

第四步：初始化客戶數據

現在，讓我們將一些客戶添加到我們的清單中。這是我們載入要寫入工作簿的資料的地方。請隨意根據需要添加更多條目。

CustomerList customers = new CustomerList();
customers.Add(new Customer("Thomas Hardy", "120 Hanover Sq., London"));
customers.Add(new Customer("Paolo Accorti", "Via Monte Bianco 34, Torino"));

在此範例中，我們正在使用一個小資料集。但是，您可以透過從資料庫或其他來源載入資料來輕鬆擴展此列表。

第 5 步：載入工作簿

現在，讓我們開啟一個包含必要智慧標記的現有 Excel 工作簿。此工作簿將作為我們的模板，Aspose.Cells 將動態地以客戶資料取代智慧標記。

string sourceDir = "Your Document Directory";
Workbook workbook = new Workbook(sourceDir + "SmartMarker1.xlsx");

確保"SmartMarker1.xlsx"包含佔位符，例如&=Customer.FullName和&=Customer.Address應該填寫資料的地方。

步驟 6：設定工作簿設計器

現在，讓我們配置工作簿設計器以將我們的客戶資料來源與工作簿的智慧標記連結起來。

WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource("Customer", new CustomerDataSource(customers));

這SetDataSource方法綁定我們的CustomerDataSource到工作簿中的智慧標記。每個標記都標有&=CustomerExcel 中的資料現在將替換為對應的客戶資料。

步驟 7：處理並儲存工作簿

最後，讓我們處理工作簿以填入資料並儲存結果。

string outputDir = "Your Document Directory";
designer.Process();
workbook.Save(outputDir + "dest.xlsx");

此程式碼觸發智慧標記處理，用資料取代所有佔位符，並將結果儲存為dest.xlsx.

結論

恭喜！您已成功實施ICellsDataTableDataSource適用於使用 Aspose.Cells for .NET 的工作簿設計者。這種方法非常適合在電子表格中自動填充數據，特別是在處理客戶清單或產品庫存等動態數據時。有了這些技能，您就可以輕鬆建立數據驅動的應用程序，使基於 Excel 的報告變得輕而易舉！

常見問題解答

什麼是`ICellsDataTable` in Aspose.Cells?

它是一個允許自訂資料來源與 Aspose.Cells 智慧標記連結以實現動態資料填充的介面。

如何自訂工作簿範本中的資料？

稱為智慧標記的佔位符，例如&=Customer.FullName，被使用。這些標記在處理過程中被替換為真實資料。

Aspose.Cells for .NET 是免費的嗎？

Aspose.Cells 提供免費試用版，但完全存取需要付費授權。檢查他們的免費試用或者買選項。

我可以動態新增更多客戶資料嗎？

絕對地！只需填充CustomerList在執行程式之前新增附加條目。

如果我遇到困難，我可以在哪裡獲得協助？

Aspose 有一個支援論壇用戶可以在這裡提出問題並從社區和 Aspose 團隊獲得幫助。

使用 Aspose.Cells 從工作簿獲取 OData 詳細信息密碼保護或取消保護共享工作簿