XtraReport.Extensions Property

Provides access to the report’s extensions.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

C#

[Browsable(false)]
public IDictionary<string, string> Extensions { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property Extensions As IDictionary(Of String, String)

Property Value

Type	Description
IDictionary<String, String>	A dictionary storing the report extensions.

Remarks

You can use the Extensions property to serialize custom objects (such as custom report parameters or custom data sources) along with a report’s definition.

See the following examples to learn how to serialize custom data sources to XML:

• How to serialize a dataset to an XML file
• How to serialize an XPO data source
• Web Report Designer - How to use the custom serializer class (IDataSerializer) to serialize the XPO data source to make it visible in the web report designer

See the following tutorials to learn how to register custom parameter types in reporting applications created for different platforms:

• Register Custom Report Parameter Types (in WinForms Applications)
• Register Custom Report Parameter Types (in WPF Applications)
• Register Custom Report Parameter Types (in Web Applications)

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Extensions 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#

reporting-winforms-custom-report-storage/CS/XpoReportStorage.cs#L54

report.Extensions["StorageID"] = item.Oid.ToString();
item.Layout = GetBuffer(report);

Reporting_How-to-add-and-use-custom-types-for-report-parameters-in-the-web-reporting-controls/CS/CustomReportParameterType/Controllers/HomeController.cs#L15

var report = new XtraReport();
report.Extensions[SerializationService.Guid] = CustomDataSerializer.Name;
return View(report);

Reporting_how-to-serialize-a-report-to-xml-with-an-untyped-dataset-as-a-data-source-t269554/CS/Form1.cs#L34

private static void InitExtensions(XtraReport report) {
    report.Extensions[SerializationService.Guid] = CustomUntypedDataSetSerializer.Name;
}

Reporting_web-report-designer-how-to-open-a-report-with-an-untyped-dataset-as-a-data-source-t269524/CS/DXApplication1/WebEUD/Default.aspx.cs#L27

private static void InitExtensions(XtraReport report) {
   report.Extensions[SerializationService.Guid] = CustomUntypedDataSetSerializer.Name;
}

VB.NET

reporting-winforms-custom-report-storage/VB/XpoReportStorage.vb#L61

report.Extensions("StorageID") = item.Oid.ToString()
item.Layout = GetBuffer(report)

Reporting_How-to-add-and-use-custom-types-for-report-parameters-in-the-web-reporting-controls/VB/CustomReportParameterType/Controllers/HomeController.vb#L17

Dim report = New XtraReport()
report.Extensions(SerializationService.Guid) = CustomDataSerializer.Name
Return View(report)

Reporting_how-to-serialize-a-report-to-xml-with-an-untyped-dataset-as-a-data-source-t269554/VB/Form1.vb#L36

Private Shared Sub InitExtensions(ByVal report As XtraReport)
    report.Extensions(SerializationService.Guid) = CustomUntypedDataSetSerializer.Name
End Sub

Reporting_web-report-designer-how-to-open-a-report-with-an-untyped-dataset-as-a-data-source-t269524/VB/DXApplication1/WebEUD/Default.aspx.vb#L29

Private Shared Sub InitExtensions(ByVal report As XtraReport)
   report.Extensions(SerializationService.Guid) = CustomUntypedDataSetSerializer.Name
End Sub