PdfExportOptions.PdfACompatibility Property

Specifies document compatibility with the PDF/A specification.

Namespace : DevExpress.XtraPrinting

Assembly : DevExpress.Printing.v25.2.Core.dll

NuGet Package : DevExpress.Printing.Core

Declaration

• C#
• VB.NET

[DefaultValue(PdfACompatibility.None)]
public PdfACompatibility PdfACompatibility { get; set; }

<DefaultValue(PdfACompatibility.None)>
Public Property PdfACompatibility As PdfACompatibility

Property Value

A PdfACompatibility enumeration value.

|

Available values:

The document is not PDF/A -compatible and supports the ISO 32000-1:2005 specification.

| | PdfA1a |

The document supports the PDF/A-1a (Accessible) specification and contains tags that assistive technologies can use.

| | PdfA1b |

The document supports the PDF/A-1b ( ISO 19005-1 ) specification.

| | PdfA2a |

The document supports the PDF/A-2a (Accessible) specification and contains tags that assistive technologies can use.

| | PdfA2b |

The document supports the PDF/A-2b ( ISO 19005-2:2011 ) specification.

| | PdfA3a |

The document supports the PDF/A-3a (Accessible) specification and contains tags that assistive technologies can use.

| | PdfA3b |

The document supports the PDF/A-3b ( ISO 19005-3:2012 ) specification.

|

Property Paths

You can access this nested property as listed below:

.Pdf .PdfACompatibility

| | WinForms Controls | DiagramOptionsExport |

.PdfExportOptions .PdfACompatibility

| | WPF Controls | DiagramControl |

.PdfExportOptions .PdfACompatibility

|

Remarks

To make a document compatible with the PDF/A specification, use the following options.

• PdfExportOptions.PdfACompatibility
• PdfExportOptions.AdditionalMetadata

If the PdfExportOptions.PdfACompatibility property is set to PdfACompatibility.None (the default value), the resulting document will conform to the ISO 32000-1:2005 standard without any restrictions.

For a code sample, refer to the following example online: How to export a report to ZUGFeRD.

For the current versions of the library, consider the following restrictions associated with PDF/A compatibility:

• All PDF/A versions implicitly prohibit encryption.
• All fonts that are used in PDF/A documents should be embedded.
• The PDF/A-1 and PDF/A-2 standards do not support attachments.
• The PDF/A-1 standard does not support transparency, and the alpha channel in images is ignored.

To check the validity of PDF export options, use the PdfExportOptions.Validate method that returns a list of any detected inconsistencies.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PdfACompatibility property.

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.

• C#

office-file-api-in-web-api-app/CS/BusinessObjects/Helpers.cs#L278

case AccessiblePdfFormat.PdfA1a:
    options.PdfACompatibility = PdfACompatibility.PdfA1a;
    return options;

See Also

PdfExportOptions Class

PdfExportOptions Members

DevExpress.XtraPrinting Namespace