DevExpress Office File API控件日前正式發布了v24.2，新版本正式官宣不再支持非Windows系統等，歡迎下載最新版組件體驗！

DevExpress技術交流群11：749942875      歡迎一起進群討論

重要變化

GDI+ (Libgdiplus) — 不再支持非Windows系統

由于官方對.NET 8的承諾，以及再去年發布跨平臺的基于SkiaSharp的引擎之后，重構了源代碼并在非Windows環境（libgdiplus）中刪除了所有與GDI+相關的方法調用。

C#

using System.IO;
using DevExpress.XtraRichEdit;
// ...
RichEditDocumentServer wordProcessor = new RichEditDocumentServer();
//...
using(FileStream stream =
new FileStream(resultFilePath, FileMode.Create, FileAccess.Write, FileShare.Read)) {
PdfExportOptions exportOptions = new PdfExportOptions();
exportOptions.PdfUACompatibility = PdfUACompatibility.PdfUA1;

wordProcessor.ExportToPdf(stream, exportOptions);
}

在Windows環境下支持Skia和取消AzureCompatibility屬性

多種DevExpress產品（Reporting、BI Dashboard和Office File API）都帶有打印和數據導出功能，適用于受限制的環境，如Microsoft Azure（其中與元文件和字體對象相關的某些GDI/GDI+調用不可用），AzureCompatibility.Enabled屬性管理此功能。

在v23.2版本周期中，官方停止了對非Windows環境中此屬性切換所提供的功能支持。在v24.2中，官方也在基于Windows的環境中逐步取消了Office File API庫中的AzureCompatibility.Enabled切換，建議在針對云/受限環境時使用基于Skia的跨平臺圖形引擎。

DevExpress Office File API庫自動確定所使用的適用繪圖引擎，您可以通過使用靜態的選項手動切換到不同的繪圖引擎。

C#

DevExpress.Drawing.Settings.DrawingEngine = DevExpress.Drawing.DrawingEngine.Skia;

Spreadsheet Document（電子表格） API

動態數組公式

v24.2擴展了公式計算引擎，并將動態數組集成到Spreadsheet Document API庫中。與標準數組公式不同，標準數組公式為每個單元格返回一個值，而動態數組函數返回一個動態的值數組（這個值數組會自動溢出到相鄰的單元格中）。

新的函數包括：

• 動態陣列計算和溢出范圍支持。
• 新的公式錯誤類型（#SPILL!）。
• 隱式交叉運算符（@符號）返回單個公式值替代數組。

 現在您可以在Spreadsheet Document API庫中導入包含動態數組公式的Excel文檔，調用方法重新計算這些公式，并將計算后的文檔保存為Excel格式，打印和導出為PDF也可用。

此外您可以在代碼中管理動態數組公式，v24.2發布了以下新API：

• - 獲取或設置基于當前工作簿區域性的單元格區域的動態數組公式。
• - 獲取或設置基于不變區域性的單元格區域的動態數組公式。
• - 指示單元格區域是否包含動態數組公式。
• - 指示當前單元格是否為動態數組公式范圍中的左上角單元格。
• - 返回動態數組公式溢出的單元格范圍。
• - 返回當前工作表的動態數組公式的集合。

如果您想使用新的API獲取、插入或清除動態數組公式，請參閱以下代碼片段：

C#

Worksheet worksheet = workbook.Worksheets.ActiveWorksheet;

// Insert dynamic array formulas
worksheet["A1"].DynamicArrayFormulaInvariant = "={\"Red\",\"Green\",\"Orange\",\"Blue\"}";
worksheet.DynamicArrayFormulas.Add(worksheet["A2"], "=LEN(A1:D1)");

// Clear dynamic array formulas
Cell cell = worksheet.Cells["B2"];
if (cell.HasDynamicArrayFormula) {

CellRange dynamicArrayRange = cell.GetDynamicArrayFormulaRange();
dynamicArrayRange.Clear();
}

worksheet.DynamicArrayFormulas.Remove(worksheet.Cells["A1"].GetDynamicArrayFormulaRange());

要抑制動態數組公式計算并恢復到以前的操作，請將WorkbookCapabilitiesOptions.DynamicArrayFormulas屬性設置為DocumentCapability.Disabled。在本例中，動態數組公式將作為標準數組公式計算。

在單元格中嵌入圖像

DevExpress Spreadsheet Document API庫（v24.2）允許您將圖像直接嵌入到工作表單元格中（使用Microsoft Excel的“Place in Cell”選項），還可以導入在工作表單元格中嵌入圖像的文檔，打印這些文檔，將其導出為PDF并將其保存到支持的Excel文件中（不會丟失內容）。

v24.2包含了用于在代碼中管理單元嵌入圖像的新API，嵌入的圖像存儲為單元格值。若要確定單元格是否有嵌入圖像，請使用CellValueIsCellImage屬性。使用CellValueImageValue屬性獲取單元格圖像值作為OfficeImage對象（允許您檢查圖像格式或獲取圖像字節）。若要在單元格中插入圖像，請將其分配給CellRangeValue屬性。Spreadsheet Document API庫支持以下對象類型作為圖像源：

• Byte[]
• System.IO.Stream
• System.Drawing.Image
• DevExpress.Drawing.DXImage
• DevExpress.Office.Utils.OfficeImage

此外，v24.2實現了指定圖像Alt Text（有意義的描述）值和將單元格圖像標記為裝飾性的選項，這些設置可以通過屬性獲得。

下面的代碼片段演示了這個新的API：

C#

byte[] imageBytes = File.ReadAllBytes("image.png");
MemoryStream imageStream = new MemoryStream(imageBytes);
DXImage dximage = DXImage.FromStream(imageStream);

// Insert cell images from a byte array, stream and DXImage object
worksheet.Cells["A1"].Value = imageBytes;
worksheet.Cells["A2"].Value = imageStream;
worksheet.Cells["A3"].Value = dximage;

// Set image Alt Text values
worksheet.Cells["A1"].ImageInfo.AlternativeText = "Image AltText";

// Mark the cell image as decorative
if (worksheet.Cells["A2"].Value.IsCellImage)
worksheet.Cells["A2"].ImageInfo.Decorative = true;

// Save the cell image to a new file
OfficeImage cellImage = worksheet.Cells["A1"].Value.ImageValue;

if (cellImage.RawFormat == OfficeImageFormat.Png) {

byte[] cellImageBytes = cellImage.GetImageBytes(cellImage.RawFormat);
File.WriteAllBytes("saved_image.png", cellImageBytes);
}

// Remove cell image
worksheet.Cells["A3"].ClearContents();

對齊和分布式垂直文本對齊

v24.2增加了對Spreadsheet單元格內的對齊和分布式垂直對齊類型的支持，具有這些對齊選項的Excel文件可以打印并導出為PDF。

 您可以使用Cell.Alignment.Vertical屬性在代碼中指定垂直對齊方式，下面的代碼片段指定了代碼中的對齊方式：

C#

var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];

Cell cellA1 = worksheet.Cells["A1"];
cellA1.Value = "Centered and Justified";
cellA1.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Center;
cellA1.Alignment.Vertical = SpreadsheetVerticalAlignment.Justify;

workbook.ExportToPdf("Result.pdf");

更多產品資訊及授權，歡迎來電咨詢：023-68661681