DevExpress Office & PDF File API for .NET 版本发布

PDF Document API for .NET

• OptimizeDocument method strips color from Indexed/DeviceRGB images when DownsamplingResolution is applied.
• PdfDocumentConverter — VeraPDF fails PDF/A-3B document validation with the "Embedded fonts shall define all glyphs referenced for rendering within the conforming file" error.
• Word Processing Document API — LZW-compressed TIFF picture is incorrectly exported to PDF on Linux/Skia.

Spreadsheet Document API for .NET

• "ConditionalFormatting.StopIfTrue" property returns 'false' for rules stored in the x14 extension (extLst) and is lost on save.
• Chart series are exported with the same fill color and the legend contains data points when "Vary Colors" is enabled on a line chart series.
• Charts.Title.Font.Name property changes only Latin font.

Word Processing Document API for .NET

• RichEditControl — TOC \t switch does not consider localized "Heading" style name.
• RichEditDocumentServer — UpdateAllFields method call doesn't calculate Table of Figures (TOC field with the '\c' switch).
• Specific resaved documents lose positions of shapes and images saved as quick parts.
• Document Property value is duplicated when Track Changes is enabled in a document.
• LZW-compressed TIFF picture is incorrectly exported to PDF on Linux/Skia.

Zip Compression and Archive API for .NET

• ZipArchive.Read method throws EndOfStreamException on an attempt to parse the Zip64 extra field of a valid Zip64 archive.

PDF Document API for .NET

• Graphic object is missing when a cloned page is resized.
• Page rotation is not preserved when a rotated page is extracted from the original document and saved.
• Characters are duplicated when a specific document is saved.
• Saved document text is corrupted if Page.Fragments is iterated.
• PDF document page with tiled JPEG 2000 (JPX) images is rendered blank when PdfDocumentProcessor exports page to an image.
• PdfDocumentConverter - VeraPDF fails PDF/A-1B document validation with font-related errors.
• PdfDocumentConverter - VeraPDF fails PDF/A-1B document validation with the following error: "Properties specified in XMP from shall use either the predefined schemas defined in XMP Specification, or extension schemas that comply with XMP Specification".

Spreadsheet Document API for .NET

• System.IndexOutOfRangeException: 'Index was outside the bounds of the array.' error occurs when evaluating formulas in a specific document.
• Leader Lines on Custom Data Labels are displayed by default.
• Workbook throws EndOfStreamException when a file with a missing theme is loaded.
• Workbook throws KeyNotFoundException on an attempt to copy many styled cells.

Word Processing Document API for .NET

• Font substitution logic is not invoked for missing fonts when a font returned by GDI+ contains all necessary font symbols.
• Legacy regional font variants are not replaced with the main font variant during font substitution.
• RichEditDocumentServer - NullReferenceException occurs on exporting a document to PDF when a specific font is added to DXFontRepository.
• Complex table's cell text doesn't fit the cell width and is wrapped.
• Horizontal rule ('o:hr') width changes after converting RTF to OpenXML.

PDF Document API

• PDF Document API (New) - "System.ArgumentException: 'An item with the same key has already been added. Key: [95, 742849]'" error occurs when a page that belongs to another document is added without "Clone".
• PDF Document API (New) - Resulting document's layout is corrupted when pages are cloned from another document.
• PDF Document API - "System.ArgumentException: 'Input data is not recognized as valid pdf.'" error is thrown when a document uses UTF-8 BOM encoding.
• PDF Document API - "System.ArgumentException: 'Input data is not recognized as valid pdf.'" error occurs in the PdfNChannelColorSpace.PdfNChannelColorSpace method.
• PDF Viewer - Annotation overlaps a form field and hides its content.
• PdfDocumentProcessor throws ArgumentException when an empty document created from a stream is finalized.

Presentation API

• Presentation API - Shape's TextProperties are not applied when specified in TextArea constructor.
• Presentation API - Shape's text is missing when it's specified in TextArea constructor.
• Presentation API - Shapes that belong to the group do not move when moving a shape group.

Word Processing Document API

• RichEditControl throws ArgumentException when a specific RTF file is loaded.
• RichEditDocumentProcessor - DocumentLoaded event is raised earlier than custom document properties are loaded.
• RichEditDocumentServer throws NullReferenceException when two documents with fields are compared.
• Word Processing Document API - Paragraph Frame position is incorrect.
• Word Processing Document API - PDF/UA-1 export fails for certain tabular documents.
• Word Processing Document API - RichEditDocumentServer.ExportToPdf method hangs when the original document contains floating text boxes.

Security Enhancements

• Secure ZIP Policy
  • The new Zip Security Policy DevExpress.Utils.Zip.SecureZipPolicy protects applications from ZIP-related attack vectors using resource limits, hard blocks, and encryption rules. You can configure resource limits globally or for individual operations. The SecureZipPolicy.TrustBoundaryViolation event allows you to log, monitor, and audit TrustBoundary violations.
• FIPS (Federal Information Processing Standards) Compliance Enforcement
  • The DevExpress API now detects operating system-level FIPS enforcement and raises an OperatingSystemLevelFipsMode.ComplianceViolationException before document processing begins. The exception includes violation details, resolution recommendations, and is raised early in the workflow to prevent non-compliant cryptographic operations.

Safer Document (DOCx, XLSx...) Processing

• Security Loading Limits
  • Use Options.SecurityLoadingLimits to configure document limits. The SecurityLoadingLimitExceeded event fires when a document exceeds a limit. In the event handler, set e.Handled = true to continue loading operation despite violations (useful for log-only scenarios or staged rollouts).
• Dangerous Content Removal
  • You can automatically remove dangerous content when loading documents using Options.SecurityLoadingOptions. Each option targets a specific threat category and fires a SecurityLoadingOptionsViolation event when matching content is detected. Set e.Handled = false in the event handler to remove detected content.
• Privacy Sanitization
  • v26.1 includes RichEditDocumentServer.Sanitize(WordProcessingSanitizeOptions) for the Word Processing Document API and Workbook.Sanitize(WorkbookSanitizeOptions) for the Spreadsheet API. Call these methods to strip personal data and internal organizational information from documents before you share, publish, or archive documents/files.
• Inspect Document Content Before Sanitization
  • Before sanitization, inspect a document/workbook to identify content types. The new RichEditDocumentServer.Inspect(WordProcessingInspectOptions) and Workbook.Inspect(WorkbookInspectOptions) methods scan a loaded file and return the detected set.

New PDF Processing API

• DevExpress PDF Document API v26.1 introduces a new DevExpress.Docs.Pdf .NET library. It allows you to create, load, modify, secure, and analyze PDF documents using an object-oriented approach. IMPORTANT: The new DevExpress PDF Document API Library is currently available as a Community Technology Preview (CTP). Note: DevExpress do not recommend that you integrate pre-release libraries into mission-critical software applications.

New Barcode Generation API

• DevExpress Office & PDF File API v26.1 introduces a new standalone Barcode Generation library (DevExpress.Docs.Barcode) for modern .NET applications. It uses strongly typed configuration objects, supports async export/cross-platform rendering, and can generate both 1D and 2D barcodes across multiple formats. Key Features:
  • 30+ supported barcode symbologies for 1D and 2D barcodes.
  • Unified BarcodeGenerator class - A single, reusable object for all symbologies and output formats.
  • Fluent-style configuration via object initializers - BarcodeOptions allow you to declare all appearance, layout, and symbology settings in one expression (without intermediate setup steps).
  • Multiple export targets - Raster and vector images (PNG, JPEG, BMP, SVG, EMF/WMF), in-memory DXImage objects, and PDF.
  • Async API - ExportAsync and ExportToImageAsync overloads for non-blocking generation in web and desktop applications.
  • Direct print support - Send a barcode directly to a printer using Print API and PrintOptions.
  • Binary-data overloads - Use raw byte arrays to encode non-textual payloads (GS1 DataMatrix, PDF417 binary segments).
  • Human-readable text control - Configure text visibility, font, alignment, word-wrap, and right-to-left direction independent of the barcode symbol itself.
  • Cross-platform rendering - Runs on Windows and Linux/macOS using the Skia rendering engine.
  • Runtime options swapping - Update BarcodeGenerator.Options at runtime to reuse a single generator instance with different configurations.
  • Add Barcodes to Documents - Insert barcodes directly into Word, Excel, PowerPoint, and PDF documents using the DevExpress Office & PDF File APIs.

Accessibility Enhancements

• PDF Export Engine - PDF/UA-2 Format Support
  • The PDF export engine now supports the PDF/UA-2 format (for enhanced accessibility compliance). You can specify PDF/UA-2 conformance for exported documents to meet the latest accessibility standards.

Presentation API

• Chart API
  • The DevExpress Presentation API v26.1 introduces a comprehensive Chart API that allows you to programmatically create, modify, and style charts within PowerPoint presentations.
• Standard Chart Types
  • Bar / Bar3D.
  • Line / Line3D.
  • Pie / Pie3D.
  • Area / Area3D.
  • Surface / Surface3D.
  • Scatter.
  • Radar.
  • Stock.
  • Doughnut.
  • Bubble.
  • Pie-of-Pie / Bar-of-Pie.
• Microsoft Office 2016+ Chart Types - The ChartEx class supports the following modern chart types:
  • Waterfall.
  • Funnel.
  • Histogram.
  • Pareto.
  • Box-and-Whisker.
  • Sunburst.
  • Treemap.
  • Map.
• Customize Chart Elements
  • The Chart API supports a broad range of real-world usage scenarios, including generating dynamic reports, embedding analytics into presentations, and building dashboards with rich data visualizations. Developers can fully control the following chart elements and appearance settings:
    • Titles and Legends.
    • Axes (primary and secondary).
    • Chart Views and Series.
    • Data Points and Labels.
    • Data Tables.
    • Trendlines and Error Bars.
    • Chart area and plot area appearance (Fill, OutlineStyle, PlotArea).
    • Default font settings for all chart text: TextProperties.
    • Styles (ChartStyle / ChartExStyle).
    • Themed color palettes (ChartColorPalette).
    • 3D view settings (View3DOptions).
• Export Slides to Images
  • The DevExpress PowerPoint Presentation API allows you to export an entire presentation or a subset of slides directly to DXImage objects. Save these objects in raster or vector image formats (PNG, BMP, JPEG, EMF, SVG, and more) and generate presentation previews/thumbnails with full visual fidelity (preserving backgrounds, themes, layouts, and shape types).

Excel Spreadsheet API

• New Excel Functions - The DevExpress Spreadsheet Document API v26.1 supports 6 new dynamic array-based Excel functions:
  • XLOOKUP.
  • XMATCH.
  • SORT.
  • SORTBY.
  • FILTER.
  • UNIQUE.

AI Agent Skills

• DevExpress AI agent skills give AI coding assistants accurate, built-in knowledge of DevExpress Office & PDF File API features through v26.1. Instead of generic training data that often produces incorrect APIs or outdated code patterns, assistants use product-specific guidance for common document processing scenarios.
• Each skill defines correct APIs, necessary assemblies, configuration steps, and implementation patterns for a specific feature area. AI assistants use this knowledge to generate accurate code for document generation, editing, conversion, export, PDF processing, barcode generation, archive management, unit conversion, and AI-powered document workflows.
• All skills follow the Agent Skills standard and work with Claude Code, GitHub Copilot (Visual Studio, VS Code, and JetBrains Rider), and Cursor.

PDF Document API

• PdfDocumentProcessor.AppendDocument throws System.NullReferenceException: 'Object reference not set to an instance of an object.'.
• "pdfaExtension" section is missing in the resulting PDF file with attached Zugferd Invoice.
• PdfDocumentProcessor can throw "System.ArgumentException: An item with the same key has already been added. Key: DevExpress.Pdf.PdfDocumentProcessor" on concurrent first-time instantiation.
• PdfDocumentConverter cannot process files with corrupt metadata.
• PdfDocumentProcessor uses incorrect font substitution for AcroForm fields on iOS.

Spreadsheet Document API

• Exception is thrown when setting the CellRange.Name property if the original document uses the R1C1 reference style.
• NullReferenceException occurs on an attempt to load a worksheet that contains the <exlLst> tag.
• NullReferenceException occurs on saving a Workbook containing a pie or doughnut chart loaded from an XLSX document.

Word Processing Document API

• HTML documents with an empty span incorrectly apply formatting settings to paragraphs following the empty span.
• NullReferenceException is thrown when specific SVG files are loaded.
• RichEditDocumentServer produces corrupt documents in environments that use ICU culture settings.
• Background thread exception is thrown when SubDocument.Delete method is called.
• System.ArgumentOutOfRangeException is thrown when the ExportToPdf method is called.
• Image from the original DOC document is rotated in the resulting PDF document.
• XtraRichEdit - Incorrect table layout when exporting to PDF.

PDF Document API

• An additional Rubber Stamp annotation is added after saving the original PDF document.
• Document that contains Roboto fonts is incorrectly rendered on Linux-based systems.
• PdfViewer and PdfDocumentProcessor hang on rendering a specific PDF document.
• The CreateDXBitmap method takes a long time to execute when Skia is enabled.

Presentation API

• Shape text is wrapped in an exported PDF document.
• Tables are exported to PDF with incorrect layouts.

Spreadsheet Document API

• Legacy comments are missing in the Worksheet.Comments collection.

Word Processing Document API

• RichEditControl throws InvalidOperationException on an attempt to export specific files to a compatible PDF.
• Adobe Accessibility Checker flags issues with table regularity on an exported PDF.
• ArgumentOutOfRangeException is thrown when ExportToPDF is called.
• Text right indent is different in the resulting PDF document.

All Office File API products

• SVG files with long headers (1024 characters) cannot be recognized.

PDF Document API

• DXFontRepository - DXFontRepository.QueryNotFoundFont event isn't raised when a document contains a missing font in MAUI applications and Docker containers.
• PDF Document API - "System.ArgumentException: 'Input data is not recognized as valid pdf.'" error occurs on saving a PDF document.
• PDF Document API - PdfDocumentProcessor.CreateDXBitmap method creates an image with a black background.
• PdfDocumentConverter - Characters are lost after converting a PDF document to PDF-A3.
• PdfDocumentProcessor - NullReferenceException occurs in the PdfStitchingFunction constructor when a page is added from a source document to the target document.

Presentation API

• Cloned slides do not preserve empty bullet list styles.
• TextParagraph.Properties.TextProperties is ignored during PDF export.

Project Converter

• Error occurs after converting a project to v25.2 (The operation has timed out).
• TypeInitializationException (The type initializer for 'Microsoft.Build.Shared.XMakeElements' threw an exception) after converting a VB.NET project.

Spreadsheet Document API

• COUNTIF function is defined as a dynamic array function.
• Spreadsheet Document API - Conditional Formatting rule isn't loaded and is missing in the resulting document.

Word Processing Document API

• RichEditControl - Paragraph that fits into the page width is wrapped.
• RichEditDocumentServer throws AccessViolationException when a document with a GIF image is saved on Azure with Skia.
• Subsequent table headers are imported with a broken layout in specific documents.
• The ConditionalStyleProperties collection is not updated after the first read attempt.
• A document with table style banding overrides fails to load.
• Auto-sized TextBox's layout is calculated incorrectly when the paragraph's Right indent is specified.
• Ink shapes are imported with incorrect size and color.
• Table layout is incorrect in the exported PDF document.

PDF Document API

• Encrypted document is corrupted and can't be opened in Adobe Acrobat Reader.
• Microsoft Sans Serif Bold is not added to a document when the Skia rendering engine is used.
• Rotated text in FreeTextAnnotations is clipped if the annotation includes a callout point.
• The ResetCompatibility method doesn't reset compatibility levels in a specific document.

Word Processing Document API

• Added custom font is not used when a document is loaded to RichEditControl or exported to PDF.
• Exporting DOCX to PDF in AllMarkup mode with ExportEditingFieldsToAcroForms enabled results in ArgumentOutOfRangeException.
• Image disappears when loaded onto RichEdit.
• Incorrect page number format when field is inside a paragraph frame.
• Saved document is corrupted when floating objects are present on the header.
• Sequence of Tabs is incorrectly rendered in RichEdit.
• TOC does not include table entries marked with character styles.
• ExportToPDF throws a NullReferenceException for particular documents.

Digital Signature API

• DocumentSigner throws the "Invalid provider type specified" exception on an attempt to sign a document with an RSA key that uses CNG Key Storage Provider under .NET Framework.

PDF Document API

• NullReferenceException is thrown when the PdfDocumentProcessor.AppendDocument method is called.
• PDF Document API - "Input data is not recognized as valid PDF" exception is thrown when saving or appending a document.
• PDF Document API - "The operation is not supported in PdfCompatibility.PdfA1b compatibility mode" error occurs when multiple PDF/A-1b documents are merged.
• PDF Document API - Document content can't be edited when CertificationLevel is set to PdfCertificationLevel.FillForms or PdfCertificationLevel.FillFormsAndAnnotate.
• PDF Document API - PDF Page Layout set to Single Page changes to Default when saved.
• PDF Document API - Text lines that contain bold text and emojis don't use the bold font.
• PdfDocumentSigner - GetPdfPkcs7Signature method throws an exception.
• Word Processing Document API - Images are missing in the resulting PDF when exporting a DOCX document that contains EMF images on Linux.

Spreadsheet Document API

• DocumentSigner throws the "Invalid provider type specified" exception on an attempt to sign a document with an RSA key that uses CNG Key Storage Provider under .NET Framework.
• Free floating shapes change their size with columns during autofit operations.
• Spreadsheet Document API - Dynamic array formulas are copied as normal formulas on copying a worksheet to a new workbook.
• XtraSpreadsheet - Rotated Shapes are shifted when exporting to HTML.

Word Processing Document API

• Document templates (.dot) with hyperlinks cannot be parsed.
• DocumentSigner throws the "Invalid provider type specified" exception on an attempt to sign a document with an RSA key that uses CNG Key Storage Provider under .NET Framework.
• Documents converted to PDF by the Skia rendering engine have incorrect table layouts.
• ODT documents have incorrect layouts when using exotic fonts.
• Online demo creates an infinite loop on converting certain documents to PDF.
• Word Processing Document API - Image position is calculated incorrectly when the image's shadow parameters are set to specific values.
• Word Processing Document API - Saved document is corrupted when using .NET Core.

Zip Compression and Archive API

• ZipArchive cannot open archives with specific files inside.