如何在 C# 中匯入和匯出 DataSet/DataTable；

IronXL 使用單一方法呼叫在 Excel 工作簿和 DataSets 之間進行轉換 - 使用 LoadWorkSheetsFromDataSet() 將 DataSets 匯入工作簿，並使用 ToDataSet() 將工作簿匯出為 DataSets，並自動進行工作表到表格的映射。

DataSet 是包含多個相關資料表、關係和約束的記憶體內資料表示。 用於處理資料庫、XML 及其他來源的資料。 在 C# 中使用 Excel 檔案時，DataSet 提供了熟悉的 .NET 結構，可與資料驅動的應用程式整合。

DataTable 表示在 DataSet 中具有行和列的單一表格。 IronXL.Excel 會自動將每個 Excel 工作表對應到相對應的 DataTable 中，並在轉換過程中保留列標題和資料類型。

快速入門：立即將工作簿匯出為 System.Data.DataSet

將工作簿轉換為 DataSet 只需呼叫一個方法。 本範例使用 ToDataSet 匯出您的整個工作簿 - 每張工作表都是 DataTable - 並可選擇識別第一行的標頭。

開始使用 IronXL

!{--01001100010010010100001001010010010000010101001001011001010111110101001101010100010001010101010 10100010111110101010001010010010010010100000101001100010111110100001001001100010011111010000100100110001001111010101

如何將資料集載入工作簿？ 使用靜態 `LoadWorkSheetsFromDataSet` 方法將 `DataSet` 匯入工作簿。 此方法需要 `DataSet` 和 `Workbook` 物件。 首先使用 `Create` 方法建立工作簿。 將 `DataSet` 物件和 `workbook` 物件傳給方法。 ```csharp :path=/static-assets/excel-content-code-examples/how-to/export-dataset-datatable-load.cs ``` `DataSet` 中的每個 `DataTable` 都會成為單獨的工作表。 表格名稱會變成工作表名稱，以維持資料組織。 對於多個資料來源，請結合[建立新的試算表](https://ironsoftware.com/csharp/excel/how-to/create-spreadsheet/)或[管理現有的工作表](https://ironsoftware.com/csharp/excel/how-to/manage-worksheet/)。 以下是一個載入具有多個資料表的 `DataSet` 的綜合範例： ```csharp using IronXL; using System.Data; // Create a DataSet with multiple tables DataSet salesData = new DataSet("CompanySales"); // Create and populate a products table DataTable productsTable = new DataTable("Products"); productsTable.Columns.Add("ProductID", typeof(int)); productsTable.Columns.Add("ProductName", typeof(string)); productsTable.Columns.Add("Price", typeof(decimal)); // Add sample data productsTable.Rows.Add(1, "Laptop", 999.99m); productsTable.Rows.Add(2, "Mouse", 19.99m); productsTable.Rows.Add(3, "Keyboard", 49.99m); // Create and populate a sales table DataTable salesTable = new DataTable("Sales"); salesTable.Columns.Add("SaleID", typeof(int)); salesTable.Columns.Add("ProductID", typeof(int)); salesTable.Columns.Add("Quantity", typeof(int)); salesTable.Columns.Add("Date", typeof(DateTime)); // Add sample sales data salesTable.Rows.Add(1, 1, 5, DateTime.Now); salesTable.Rows.Add(2, 2, 25, DateTime.Now.AddDays(-1)); salesTable.Rows.Add(3, 3, 10, DateTime.Now.AddDays(-2)); // Add tables to DataSet salesData.Tables.Add(productsTable); salesData.Tables.Add(salesTable); // Create workbook and load DataSet WorkBook workBook = WorkBook.Create(); WorkBook.LoadWorkSheetsFromDataSet(salesData, workBook); // Save the workbook with all imported data workBook.SaveAs("SalesReport.xlsx"); ``` 在 [ 從 SQL 資料庫匯出資料](https://ironsoftware.com/csharp/excel/examples/excel-sql-dataset/)或將多個來源的資料整合為 Excel 格式時，此方法非常有效。 請造訪 [如何載入現有試算表](https://ironsoftware.com/csharp/excel/how-to/load-spreadsheet/)，瞭解從各種檔案格式匯入試算表的方法。

---

如何將工作簿匯出為資料集？ `ToDataSet` 方法會將工作簿轉換為 **System.Data.DataSet**，其中每個工作表都會變成 **System.Data.DataTable**。 在 Excel 工作簿上呼叫此方法，將其轉換為 `DataSet` 物件。 **useFirstRowAsColumnNames** 參數決定是否使用第一行作為列名。 ```csharp :path=/static-assets/excel-content-code-examples/how-to/export-dataset-datatable-export.cs ``` IronXL 會自動處理資料類型轉換，並在匯出至 DataSets 時維持試算表結構。 這在 [ 整合 Excel 資料與 SQL 資料庫](https://ironsoftware.com/csharp/excel/examples/excel-sql-datatable/)，或在其他 .NET 應用程式中使用資料時有所幫助。 演示工作簿匯出和 DataSet 處理的進階範例： ```csharp using IronXL; using System; using System.Data; // Load an existing Excel file WorkBook workBook = WorkBook.Load("FinancialData.xlsx"); // Export to DataSet with column headers from first row DataSet financialDataSet = workBook.ToDataSet(useFirstRowAsColumnNames: true); // Process each DataTable in the DataSet foreach (DataTable table in financialDataSet.Tables) { Console.WriteLine($"Processing table: {table.TableName}"); Console.WriteLine($"Columns: {table.Columns.Count}, Rows: {table.Rows.Count}"); // Iterate through columns foreach (DataColumn column in table.Columns) { Console.WriteLine($" Column: {column.ColumnName} ({column.DataType})"); } // Process first 5 rows as example int rowCount = 0; foreach (DataRow row in table.Rows) { if (rowCount++ >= 5) break; // Access data by column name foreach (DataColumn col in table.Columns) { Console.WriteLine($" {col.ColumnName}: {row[col]}"); } } } // You can also export specific worksheets as DataTables WorkSheet specificSheet = workBook.WorkSheets["Q1Sales"]; DataTable q1Data = specificSheet.ToDataTable(useFirstRowAsColumnNames: true); // Use the DataTable with other .NET components // For example, bind to a DataGridView or save to database ``` 匯出的 `DataSet` 維護在 Excel 中定義的關係和約束，非常適合 [使用複雜的 Excel 資料結構](https://ironsoftware.com/csharp/excel/how-to/c-sharp-excel-interop/)，而不需要 Excel Interop 的依賴。 ## 額外的 DataSet/DataTable 功能 IronXL 在使用 `DataSet` 和 `DataTable` 時提供進階功能： ### 處理資料類型 IronXL.Excel 可在 Excel-DataSet 轉換過程中智慧地對應資料類型。 數字單元格會變成適當的數字類型 (`int`, `decimal`, `double`), 日期單元格會變成 `DateTime` 物件, 文字單元格會變成 `string`s. 透過 [ 在轉換前設定儲存格資料格式](https://ironsoftware.com/csharp/excel/how-to/set-cell-data-format/)來自訂。 ### 效能最佳化 IronXL 優化大型資料集的記憶體使用量和處理速度。 這個函式庫能有效率地串流資料，而非將所有資料載入記憶體。 適用於處理大量資料的 [ 企業應用程式](https://ironsoftware.com/csharp/excel/licensing/)。 ### 與其他功能整合 DataSet/DataTable 功能與其他 IronXL 功能整合： - 在匯出到 `DataSet` 之前套用 [ 公式和計算](https://ironsoftware.com/csharp/excel/how-to/edit-formulas/)。 - 在轉換前使用 [ 條件格式化](https://ironsoftware.com/csharp/excel/how-to/conditional-formatting/)來強調資料 - 結合[圖表製作](https://ironsoftware.com/csharp/excel/how-to/csharp-create-excel-chart-programmatically/)進行視覺化報告 請造訪 [ 如何儲存或匯出試算表](https://ironsoftware.com/csharp/excel/examples/export-excel-spreadsheet/)，瞭解如何將試算表匯出為各種檔案格式。