XtraReport.ExportToPdf(String, PdfExportOptions) Method
Exports a report to the specified file in PDF format.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v24.2.dll
NuGet Package: DevExpress.Reporting.Core
#Declaration
public void ExportToPdf(
string path,
PdfExportOptions options = null
)
#Parameters
Name | Type | Description |
---|---|---|
path | String | The path to the exported PDF file. |
#Optional Parameters
Name | Type | Default | Description |
---|---|---|---|
options | Pdf |
null | The PDF export options. You can omit this parameter to use the current report export options. |
#Remarks
Note
Once the document export has started, it runs to completion and you cannot interrupt or cancel it.
This method exports a report to a file in PDF format with the specified PDF export options.
If you do not specify export options, the method uses the current report export options. To access the report export options, use the XtraReport.ExportOptions.Pdf
notation.
Important
This method overwrites files with the same name without confirmation.
Use the ExportToPdfAsync(String, PdfExportOptions, CancellationToken) method instead of ExportToPdf to export a report asynchronously in a separate task.
#Example
This example demonstrates how to export a report to PDF format.
The project uses the XtraReport.ExportToPdf method with the PdfExportOptions object as a parameter.
Note
The complete sample project How to export a report to PDF format is available in the DevExpress Examples repository.
Imports DevExpress.XtraPrinting
Imports System
Imports System.Collections.Generic
Imports System.Windows.Forms
' ...
Namespace WindowsFormsApplication1
Partial Public Class Form1
Inherits Form
Public Sub New()
InitializeComponent()
End Sub
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) Handles button1.Click
' A path to export a report.
Dim reportPath As String = "c:\\Temp\Test.pdf"
Using report As New XtraReport1()
' Specify PDF-specific export options.
Dim pdfOptions As PdfExportOptions = report.ExportOptions.Pdf
' Specify the pages to be exported.
pdfOptions.PageRange = "1, 3-5"
' Specify the quality of exported images.
pdfOptions.ConvertImagesToJpeg = False
pdfOptions.ImageQuality = PdfJpegImageQuality.Medium
' Specify the PDF/A-compatibility.
pdfOptions.PdfACompatibility = PdfACompatibility.PdfA3b
' The following options are not compatible with PDF/A.
' The use of these options will result in errors on PDF validation.
'pdfOptions.NeverEmbeddedFonts = "Tahoma;Courier New";
'pdfOptions.ShowPrintDialogOnOpen = true;
' If required, you can specify the security and signature options.
'pdfOptions.PasswordSecurityOptions
'pdfOptions.SignatureOptions
' If required, specify necessary metadata and attachments
' (e.g., to produce a ZUGFeRD-compatible PDF).
'pdfOptions.AdditionalMetadata
'pdfOptions.Attachments
' Specify the document options.
pdfOptions.DocumentOptions.Application = "Test Application"
pdfOptions.DocumentOptions.Author = "DX Documentation Team"
pdfOptions.DocumentOptions.Keywords = "DevExpress, Reporting, PDF"
pdfOptions.DocumentOptions.Producer = Environment.UserName.ToString()
pdfOptions.DocumentOptions.Subject = "Document Subject"
pdfOptions.DocumentOptions.Title = "Document Title"
' Checks the validity of PDF export options
' and return a list of any detected inconsistencies.
Dim result As IList(Of String) = pdfOptions.Validate()
If result.Count > 0 Then
Console.WriteLine(String.Join(Environment.NewLine, result))
Else
report.ExportToPdf(reportPath, pdfOptions)
End If
End Using
End Sub
End Class
End Namespace
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the ExportToPdf(String, PdfExportOptions) method.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.