Back to Devexpress

Export Options Panel

xtrareports-403482-web-reporting-blazor-reporting-native-report-viewer-interface-elements-export-options-panel.md

latest28.3 KB
Original Source

Export Options Panel

  • Feb 09, 2026
  • 14 minutes to read

The Export Options panel allows a user to specify document export settings:

Review the following help topic for more information: Export Reports.

CSV Export Options

EncodingGets or sets the encoding of the text-based file to which a report is exported.Quote Strings with SeparatorsGets or sets a value indicating whether a string with separators should be placed in quotation marks when a document is exported to a Text-based file.SeparatorSpecifies the symbol(s) to separate text elements when a document is exported as a Text-based file.Skip Empty RowsSpecifies whether or not to include the empty rows into the resulting CSV file.Skip Empty ColumnsSpecifies whether or not to include the empty columns into the resulting CSV file.Text Export ModeGets or sets a value indicating whether to use the formatting of the data fields in the bound dataset for the cells in the exported TXT, CSV, XLS or XLSX document.

DOCX Export Options

Floating PicturesSpecifies whether to embed floating pictures into exported DOCX files.Empty First Page Header/FooterSpecifies whether to display the header and footer contents on the exported document’s first page.Export Mode

Gets or sets a value indicating how a document is exported to DOCX.

The following modes are available:

  • Single FileA document is exported to a single file. In this mode, page headers and footers are added to the resulting DOCX file only once, at the beginning and end of the document.
  • Single File (Page-by-Page)A document is exported to a single file, page-by-page.

Export Page BreaksSpecifies whether or not page breaks should be included in the resulting file when a document is exported to RTF/DOCX.Export WatermarksSpecifies whether or not watermarks should be included in the resulting file.Keep Row HeightSpecifies whether the height of table rows in a resulting document should have fixed values, or adding a new line of text to a cell’s content should increase the row height.Page Range Specifies the range of pages to be exported. Use commas to separate page numbers. Use hyphens to set page ranges.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.Rasterize ImagesSpecifies whether or not vector images should be rasterized on export to the corresponding document format.Table LayoutSpecifies whether to use the table or frame layout in the resulting DOCX file.Document Options The Document Options property contains options that specify the document properties of the created DOCX file.

HTML Export Options

Character SetGets or sets the encoding name used when exporting a document to HTML.Embed Images in HTMLSpecifies whether or not images are embedded in HTML content.Export Mode Gets or sets a value indicating how a document is exported to HTML. The following modes are available:

Export WatermarksSpecifies whether to export watermarks to HTML along with the rest of the document content.Inline CSSSpecifies whether the style properties are written to the <head> section of an HTML document, or they are defined at the same place where a specific style is assigned in a document.Page Border ColorGets or sets the color of page borders when a document is exported to HTML page-by-page.Page Border WidthGets or sets the width (in pixels) of page borders when a document is exported to HTML page-by-page.Page RangeGets or sets the range of pages to be exported.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.Remove Secondary SymbolsGets or sets a value indicating whether secondary symbols should be removed from the resulting HTML file, to reduce its size.Table LayoutDetermines whether to use the table or non-table layout in the resulting HTML file.TitleGets or sets a title of the created HTML fileUse HRef HyperlinksSpecifies whether or not the document navigation is implemented by using scripts.

Image Export Options

Export Mode

Specifies whether document pages are exported to a single or multiple images. The following modes are available:

Exports the document to a single image without indicating the borders of individual pages.

The document’s page headers and footers, and the top and bottom margins are repeated only once - at the beginning and end of the resulting image.

When this export mode is used, the ImageExportOptions.PageRange property is ignored.

The document is exported to a single image with borders drawn around each page.

The document’s page headers and footers, and top and bottom margins appear on every page.

The border settings are specified by the ImageExportOptions.PageBorderWidth and ImageExportOptions.PageBorderColor properties.

Exports each document page to a separate image (with the image file name indicating the page number).

The document’s page headers and footers, and the top and bottom margins are repeated only once - at the beginning and end of the resulting image.

FormatSpecifies the image format for exporting a document.Page Border ColorSpecifies the page border color when a document is exported to a single image page-by-page.Page Border WidthSpecifies the page border width (in pixels) when a document is exported to a single image page-by-page.Page RangeSpecifies the range of pages to be exported.ResolutionSpecifies the image resolution (in DPI).Retain Background TransparencySpecifies whether a report is printed with a white or transparent background when the XtraReport.PageColor (BrickGraphics.PageBackColor) property is set to transparent.Text Rendering ModeSpecifies the quality of text rendering in images (especially in images having small DPI values and a transparent background).

MHT Export Options

Export Mode Gets or sets a value indicating how a document is exported to HTML. The following modes are available:

Export WatermarksSpecifies whether to export watermarks to HTML along with the rest of the document content.Inline CSSSpecifies whether the style properties are written to the <head> section of an HTML document, or they are defined at the same place where a specific style is assigned in a document.Page Border ColorGets or sets the color of page borders when a document is exported to HTML page-by-page.Page Border WidthGets or sets the width (in pixels) of page borders when a document is exported to HTML page-by-page.Page RangeGets or sets the range of pages to be exported.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.Remove Secondary SymbolsGets or sets a value indicating whether secondary symbols should be removed from the resulting HTML file, to reduce its size.Table LayoutDetermines whether to use the table or non-table layout in the resulting HTML file.TitleGets or sets a title of the created HTML fileUse HRef HyperlinksSpecifies whether or not the document navigation is implemented by using scripts.

PDF Export Options

Convert Images to JPEGSpecifies whether to convert the bitmap and meta file images contained in the document to JPEG format during the export to PDF.Export Edit Fields to AcroFormsSpecifies whether to convert editable fields to AcroForms fields on PDF export.Image QualityGets or sets the quality of images in the resulting PDF file.Never Embedded FontsGets or sets a semicolon-delimited string of values with the font names which should not be embedded in the resulting PDF file.Page RangeGets or sets the page range to be exported.PDF/A CompatibilitySpecifies document compatibility with the PDF/A specification.PDF/UA CompatibilitySpecifies document compatibility with the PDF/UA specification.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.Rasterize ImagesSpecifies whether or not vector images should be rasterized on export to the corresponding document format.Show Print Dialog on OpenGets or sets whether to display the Print dialog when a PDF file is opened.Signature Options

Provides access to digital signature options of PdfExportOptions.

This option is available in the Report Viewer for Blazor Server. Implement the IPdfSignatureOptionsProviderAsync interface to pass a signature collection to the Report Viewer.

Document Options The Document Options property contains options that specify the document properties of the newly created PDF file.Security Options

This property allows you to adjust the password security options of the resulting PDF file.

RTF Export Options

Empty First Page Header/FooterSpecifies whether to display the header and footer contents on the exported document’s first page.Export Mode Gets or sets a value indicating how a document is exported to RTF. The following modes are available:

  • Single FileA document is exported to a single file. Note that in this mode, page headers and footers are added to the resulting RTF file only once, at the beginning and at the end of the document.
  • Single File (Page-by-Page)A document is exported to a single file, page-by-page.

Export Page BreaksSpecifies whether or not page breaks should be included in the resulting file when a document is exported to RTF/DOCX.Export WatermarksSpecifies whether or not watermarks should be included in the resulting file.Keep Row HeightSpecifies whether the height of table cells in a resulting document should have fixed values, or adding a new line of text to a cell’s content should increase the row height.Page Range Specifies the range of pages to be exported. Use commas to separate page numbers. Use hyphens to set page ranges.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.

Text Export Options

EncodingGets or sets the encoding of the text-based file to which a report is exported.Quote Strings with SeparatorsGets or sets a value indicating whether a string with separators should be placed in quotation marks when a document is exported to a Text-based file.SeparatorSpecifies the symbol(s) to separate text elements when a document is exported as a Text-based file.Text Export Mode Specifies how data field values are formatted in the exported document. If this option is set to Text , data fields are exported as strings and appear identical to those in the document. If the option is set to Value , data field values are exported as text with default formatting.

XLS Export Options

Export HyperlinksSpecifies whether or not hyperlinks should be exported to Excel.Export ModeSpecifies whether the document should be exported to a single or different XLS files, each page in a separate file.Fit To Printed Page HeightGets or sets whether the output document should be fit to the page height when printed.Fit To Printed Page WidthGets or sets whether the output document should be fit to the page width when printed.Ignore ErrorsSpecifies the document errors to be ignored in a resulting Excel file.Page RangeGets or sets the range of pages to be exported.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.Rasterize ImagesSpecifies whether or not vector images should be rasterized on export to the corresponding document format.Raw Data ModeEnables the mode that produces simple tabular data without graphic elements, style and appearance settings.Right to Left DocumentGets or sets whether the layout of the resulting XLS document should be aligned to support locales using right-to-left fonts.Sheet NameGets or sets a name of the sheet in the created XLS file to which a document is exported.Show Grid LinesGets or sets whether worksheet gridlines are visible in the resulting XLS file.Suppress 256 Columns WarningGets or sets a value indicating whether to suppress the exception that raises when trying to export a document to an XLS file with more than 256 columns.Suppress 65536 Rows WarningGets or sets a value indicating whether to suppress the exception that raises when trying to export a document to an XLS file with more than 65,536 rows.Text Export ModeGets or sets a value indicating whether the cells in the resulting XLS document should use the same formatting as the original document.Workbook Color Palette ComplianceSpecifies the color palette compatibility mode with different workbooks versions.Document Options The Document Options property contains options that specify the document properties of the newly created XLS file.Encryption Options This property allows you to adjust the encryption options of the resulting XLS file.

Type Lists the supported encryption types. Specifies one of the following encryption types:

XLSX Export Options

Export HyperlinksSpecifies whether or not hyperlinks should be exported to Excel.Export ModeSpecifies whether the source is exported as a single XLSX file or multiple files, and whether each page is exported as a separate worksheet.Fit To Printed Page HeightGets or sets whether the output document should be fit to the page height when printed.Fit To Printed Page WidthGets or sets whether the output document should be fit to the page width when printed.Ignore ErrorsSpecifies the document errors to be ignored in a resulting Excel file.Page RangeGets or sets the range of pages to be exported.Rasterization ResolutionSpecifies the resolution (in DPI) used to rasterize vector images on export to the corresponding document format.Rasterize ImagesSpecifies whether or not vector images should be rasterized on export to the corresponding document format.Raw Data ModeEnables the mode that produces simple tabular data without graphic elements, style and appearance settings.Right to Left DocumentGets or sets whether the layout of the resulting XLS document should be aligned to support locales using right-to-left fonts.Sheet NameGets or sets a name of the sheet in the created XLS file to which a document is exported.Show Grid LinesGets or sets whether worksheet gridlines are visible in the resulting XLS file.Text Export ModeGets or sets a value indicating whether the cells in the resulting XLS document should use the same formatting as the original document.Document Options The Document Options property contains options that specify the Document properties of the newly created XLS file.Encryption Options This property allows you to adjust the encryption options of the resulting XLS file.

Type Lists the supported encryption types. Specifies one of the following encryption types:

  • StrongApplies the Agile Encryption mechanism.
  • CompatibleApplies the Standard Encryption mechanism that is compatible with Excel 2007.