Click or drag to resize
Supported File Formats

GemBox.Spreadsheet supports multiple file formats with varying degree of support.

The following sections explain file formats support in more detail and present other, file format specific, valuable information:

GemBox.Spreadsheet Feature Support

Following list describes each icon used in the subsequent table(s).

  • Feature is supported  - Feature is supported (it can be created, modified or removed with GemBox.Spreadsheet).

  • Feature is not applicable for file format  - Feature is not applicable for file format (file format is not designed to support this kind of feature).

  • Feature is not supported  - Feature is not supported (it cannot be created, modified or removed with GemBox.Spreadsheet, nor it will be preserved when loading and saving to the same file format).

GemBox.Spreadsheet Feature Support

Feature

XLSX

XLS

ODS

CSV

TXT

HTML

PDF

XPS

Image *

Reading

File formats from which GemBox.Spreadsheet can read.

Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is not supported
Feature is not supported
Feature is not supported

Writing

File formats to which GemBox.Spreadsheet can write.

Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported
Feature is supported

Document Properties

Built-in & custom workbook properties.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format

Cell/Row/Column Formatting

Number formats, text alignment, font settings, borders, background fill, column width, row height.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported
Feature is supported

In-line Text Formatting

Different font settings for parts of a textual cell value.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is supported
Feature is supported
Feature is supported

Conditional Formatting

Conditional Formatting is loaded from and saved to XLSX file format only.

Conditional Formatting calculation is currently not supported.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is not supported
Feature is not supported
Feature is not supported

Row/Column Outline & Group

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is not supported
Feature is not supported
Feature is not supported

Defined Names & Formulas

Workbook and worksheet scope defined names, formula reading/writing.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format

Pictures

JPEG, PNG, GIF, BMP, TIF, EMF, EXIF, ICO.

Feature is supported
Feature is not supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported
Feature is supported

Charts

Column, Bar, Line, Area, Pie.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported
Feature is supported

Hyperlinks

Internal & external hyperlinks.

Feature is supported
Feature is not supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is not supported
Feature is not applicable for file format

Comments

Text, author, visibility and size.

Feature is supported
Feature is not supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is not supported
Feature is not applicable for file format

Pivot Tables

Pivot Tables are loaded from and saved to XLSX file format only.

Pivot Table data calculation is currently not supported.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is not supported
Feature is not supported
Feature is not supported

AutoFilter & SortState

Filtering and sorting can be executed in spreadsheet read from any input file format.

Filtering and sorting settings are loaded from and saved to XLSX file format only.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format

Data Validation

Validation criteria, input message, error alert.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format

Sheet Header & Footer

First page, even pages and default header/footer.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is supported
Feature is supported
Feature is supported

Sheet Horizontal & Vertical Page Breaks

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported

Sheet Split/Freeze Panes

Set pane state and position.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format

Sheet Page Setup

Margins, orientation, size, etc.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported

Sheet View & Print Options

Gridlines, headings, etc.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is supported
Feature is supported
Feature is supported
Feature is supported

Workbook Encryption

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is not supported
Feature is not applicable for file format

Sheet Protection Options

Simple password sheet protection, restrict selection, insertion, removal, editing, etc.

Feature is supported
Feature is supported
Feature is supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format

Certain Charts, Drawing Shapes, Embedded Objects

  • - supported only through preservation,

  • - cannot be created, modified or removed with GemBox.Spreadsheet,

  • - can only be preserved when loading and saving to XLSX file format.

Feature is supported
Feature is not supported
Feature is not supported
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not applicable for file format
Feature is not supported
Feature is not supported
Feature is not supported

GemBox.Spreadsheet supports writing worksheet to following image formats:

  • Portable Network Graphics (PNG) format,

  • Joint Photographic Experts Group (JPEG) format,

  • Graphics Interchange Format (GIF),

  • Bitmap (BMP) format,

  • Tagged Image File Format (TIFF),

  • Windows Media Photo (WMP) format.

Note Note

Open XML (.XLSX) and OpenDocument (.ODS) formats have become industry standards, because they are open, standardized and extensible.

You can read XLSX files in Microsoft Excel 2003 and older by using Microsoft compatibility pack.

ODS files are fully supported in Microsoft Excel 2007 SP2.

Additional conversion outputs

In addition to exporting to a file or a stream, GemBox.Spreadsheet also supports printing a workbook (ExcelFilePrint method) and converting a workbook to the following types:

These outputs are especially useful in WPF applications, by providing a means to embed a spreadsheet in your WPF application with DocumentViewer and Image controls.

Following code snippet shows how to assign a ExcelFile instance to DocumentViewer and Image controls:

// Assign an ExcelFile instance to DocumentViewer control.
documentViewer.Document = workbook.ConvertToXpsDocument(SaveOptions.XpsDefault).GetFixedDocumentSequence();

// Assign an ExcelFile instance to Image control.
image.Source = workbook.ConvertToImageSource(SaveOptions.ImageDefault);

Additionally, worksheet drawings (pictures, charts, etc.) can be exported to PDF, XPS and image formats; printed or embedded in WPF application. For more information, see drawing export.

Support level for PDF, XPS and image formats

Exporting a spreadsheet to a fixed document file format, such as PDF and XPS, and to image formats is accomplished with GemBox.Spreadsheet internal paginator and renderer that are commonly used for all formats mentioned.

This means that PDF, XPS and image formats share the same level of support for spreadsheet features, since they are all rendered in the same way.

The following list contains GemBox.Spreadsheet API members that are, currently, not supported when exporting to PDF, XPS and image formats:

Note Note

Support for these members will be added in future versions of GemBox.Spreadsheet based on customer feedback.

Support for Partially Trusted applications

Most of the Internet Service Providers restrict hosted ASP.NET applications to Medium Level Trust and by doing so, disable accessing files outside the application directory, among other things, as explained in trust Element (ASP.NET Settings Schema) level Attribute.

GemBox.Spreadsheet support for Partially Trusted applications depends on the used file formats as follows:

  • Excel Workbooks (XLSX), Excel 97-2003 Workbooks (XLS), OpenDocument Spreadsheets (ODS), Character-separated-values text files (CSV), Fixed-columns-width text files (TXT) and Web Pages (HTML) are fully supported in Partially Trusted applications.

  • Adobe Portable Document Format (PDF) is supported in Partially Trusted applications if font location is set to a directory that is available to the Partially Trusted application.

    Important note Important

    Setting the font location directory is necessary for Partially Trusted applications because they can only access files inside the application directory, and font files are, by default, located in C:\Windows\Fonts, which is restricted to Partially Trusted applications.

    For more information on how to set font location directory, see Private Fonts sample.

    Font files are, usually, copyrighted, so make sure you conform to the font license, before copying a font file to another location.

  • Microsoft XMP Paper Specification (XPS) is not supported in Partially Trusted applications because ReachFramework.dll assembly, where most of the XPS implementation resides, is not decorated with AllowPartiallyTrustedCallersAttribute.

  • Image formats (PNG, JPEG, GIF, BMP, TIFF, WMP) are not supported in Partially Trusted applications because BitmapEncoder class and its derived classes, used for writing image data to the specific image file format, do not work in partial trust.

  • Printing is not supported in Partially Trusted applications because it uses XPS infrastructure.