近日，葡萄城服務端表格組件GcExcel正式發布 V7.2 新版本。此次更新帶來了諸多創新特性，旨在提升您的文檔處理體驗。以下是本次發布的主要亮點：

• 引入對多種高級 MS Excel 特性的支持，提供更加強大和靈活的工具；

• GcExcel 模板的重要升級，增強了特性和性能，使模板創作更加高效；

• 新增與 SpreadJS 的集成特性，包括處理 SJS JSON 文件的新方法重載。

這些增強與新功能將幫助您更有效地管理和操作您的文檔，無論是在創建模板、處理數據還是在集成不同平臺方面，都將帶來前所未有的便捷。如下是主要更新點。

異步IMAGE函數

Excel 中的 IMAGE 函數允許用戶將圖像直接插入單元格，從而增強電子表格的視覺吸引力，例如要點說明、添加 Logo 或結合數據以說明分析。在最新版本中，GcExcel 現在包括 IMAGE 函數，允許用戶在單元格內添加圖像。支持的圖像類型與 ImageType 枚舉中可用的類型相同。此外，GcExcel 還添加了 Workbook.WebRequestHandler 接口，允許用戶自定義如何發送網絡請求，通過 WebRequestHandler，IMAGE 函數可以通過 URL 顯示來自在線來源的圖像，該接口允許異步處理網絡請求，并提供了一種向指定 URI 發送 GET 請求的方法，這在 導出 PDF 時很有用。

參考以下代碼，了解在單元格中如何設置圖像。

Workbook.WebRequestHandler = new WebRequestHandler();
var workbook = new Workbook();
var sheet = workbook.ActiveSheet;

sheet.Range["A1"].Formula = "=IMAGE(\"https://support.content.office.net/en-us/media/926439a2-bc79-4b8b-9205-60892650e5d3.jpg\")";

workbook.Calculate();
workbook.WaitForCalculationToFinish();

workbook.Save("D:\\res.pdf");

新增 Goal Seek 功能

Excel 的目標求解功能使用戶能夠確定達到期望結果所需的輸入值。通過設置一個目標輸出，目標求解功能會自動調整輸入值，直到達到期望的結果。此功能在場景分析和 Excel 建模過程中，對決策制定具有較高的實用價值。

GcExcel 新增了一個 API，可以通過編程方式在電子表格中添加目標求解功能。新的 IRange.GoalSeek(double goal, IRange changingCell) 方法（布爾值）嘗試通過修改指定的 changingCell，來實現由 IRange 所代表的單元格中的公式計算結果達到指定的目標。goal 參數指定了期望的目標輸出，而 changingCell 參數指定了將改變其值以實現目標值的單元格。

數據透視表中的標簽篩選和數值篩選

在V7.2版本中，GcExcel增強了數據透視表篩選的支持，使開發人員能夠以編程方式在數據透視表中優化和管理大型數據集。GcExcel新增的篩選選項有助于縮小數據范圍，專注于特定條件，從而使分析更加精確和相關。

GcExcel 支持新的 API 在數據透視表中添加標簽篩選（包括日期篩選）和數值篩選。標簽篩選 API 有助于根據行或列字段中的標簽篩選數據，而數值篩選 API 則用來顯示滿足特定條件的數值數據。GcExcel 提供的 IPivotField 接口的 PivotFilters 屬性，使用戶可以使用 PivotFilterType 枚舉添加標簽、數值或日期篩選到數據透視表字段中，該枚舉可以作為參數傳遞給IPivotFilters接口的Add方法。新的API添加還包括 AllowMultipleFilters 屬性，幫助在一個字段上同時添加標簽和數值篩選，從而允許開發人員在一個字段上添加多個篩選。新API添加還包括ClearLabelFilter、ClearValueFilter和ClearAllFilters方法以刪除篩選。

GcExcel 模板增強：根據數據源進行數據過濾

在業務場景中，開發人員會整合來自多個數據源的數據，這些數據之間往往存在著關系。GcExcel 現在支持通過在 Excel 模板中定義過濾屬性來表示這些關系。單個模板單元格可以對應數據源中的多條記錄，開發人員可以相應地過濾擴展數據。模板中的過濾屬性也可以輕松修改，使報告能夠動態適應不斷變化的數據。

模板數據過濾功能，僅支持 .NET 中的 System.Data.DataTable 或 ITableDataSource 以及 Java 中的 java.sql.ResultSet 或 ITableDataSource 。

GcExcel 增加了使用 F 或 Filter 屬性定義過濾條件和過濾切片的功能。過濾屬性可以添加到 Excel 模板文件的所需單元格中，條件過濾的語法是

F/Filter = (field1 > 1 and field2 = 2 or field3 <> 3),

GcExcel 同樣增強了從多張表中進行數據處理和報告生成的能力。在條件過濾屬性，您可以使用 AND、OR、NOT 和 LIKE 等操作符和關鍵來表示不同過濾條件間的關系。

切片過濾屬性則通過指定從一個索引到另一個索引的范圍來實現數據提取。切片過濾屬性可以使用以下語法添加到 Excel 模板文件的所需單元格中：

F/Filter = [start:stop:step]

此外，您也可以將條件過濾屬性和切片過濾屬性結合起來，GcExcel 會先過濾具有條件過濾屬性的記錄，然后根據應用的切片過濾屬性過濾記錄。語法如下：

F/Filter = [start:stop:step](field1 > 1 and field2 = 2 or field3 <> 3)

以下示例展示了一個復雜的業務場景，該場景展示了如何通過在兩個表中各自的單元格上應用雙重過濾條件，精準地提取所需數據。

新增迷你圖

GcExcel 現在支持通過對應的新函數來添加線型、柱狀以及盈虧迷你圖。迷你圖是嵌入在單元格內的緊湊且簡單的圖表，用來直觀地展示數據趨勢。你可以在GcExcel中使用以下語法來添加迷你圖：

=LINESPARKLINE(data,dataOrientation,[dateAxisData],[dateAxisOrientation],[setting]).

=COLUMNSPARKLINE(data,dataOrientation,[dateAxisData],[dateAxisOrientation],[setting]).

=WINLOSSSPARKLINE(data,dataOrientation,[dateAxisData],[dateAxisOrientation],[setting]).

如果想了解每個參數的具體用法，請參考 SpreadJS 迷你圖。

注釋：在電子表格中添加迷你圖（Sparklines）的支持是 SpreadJS 的一個特性，這些函數的結果將在 SpreadJS 的 SSJSON I/O、SJS I/O、PDF、圖像和 HTML 導出文件中可見。

worksheet.Range["G3:G5"].Formula = "=COLUMNSPARKLINE(B3:F3,1,,,\"{showMarkers:TRUE}\")";
worksheet.Range["G3:G5"].Formula = "=LINESPARKLINE(B3:F3,1,,,\"{showMarkers:TRUE,lineWeight:1.5,markersColor:#7030a0}\")";
worksheet.Range["G3:G5"].Formula2 = "=WINLOSSSPARKLINE(B3:F3-300000,1,,,\"{showNegative:TRUE}\")";

下圖展示了一個在 SpreadJS 中添加到電子表格的柱狀迷你圖（Column Sparkline）。

基于像素的渲染 PDF 和圖像

為了增強電子表格內容導出 PDF 和圖像的性能，并使其渲染效果更接近于 SpreadJS，GcExcel 引入了 WorkbookOptions 類，該類提供了一個屬性 —— PixelBasedColumnWidth。如果將其設置為true，則在將電子表格渲染為 PDF 和圖像時，工作簿會采用基于像素的列寬。此外，此選項會讓其他 API 行為，如自動調整列寬和其他 PDF 及圖像渲染結果，更加接近于SpreadJS的效果。

在導出到PDF時定制邊框樣式

GcExcel 現在允許您使用 PdfSaveOptions 類中的新 BorderOptions 屬性來導出帶有自定義邊框樣式的 PDF 文檔。此屬性利用了 CustomBorderStyle 類的 BorderWidth 和 Dashes 屬性，以及BorderLineStyle 枚舉，以定義邊框寬度、虛線段長度和線條樣式。BorderWidth 屬性設置在導出 PDF 文檔時的邊框寬度，而 Dashes 屬性確定虛線中每一段的長度。

總結

GcExcel V7.0 Update2 的發布，標志著服務端表格組件的新高度。葡萄城將繼續致力于為用戶提供更強大、靈活的工具，助力各行業開發者在文檔管理和報表生成方面的創新和發展。

如需了解更多關于 GcExcel V7.0 Update2 的信息，請訪問葡萄城官方網站。