| title | Custom report item architecture | |
|---|---|---|
| description | Learn how the custom report item architecture is an extension that allows developers to add functionality that isn't natively supported in the RDL. | |
| ms.date | 09/25/2024 | |
| ms.service | reporting-services | |
| ms.subservice | custom-report-items | |
| ms.topic | reference | |
| ms.custom |
|
|
| helpviewer_keywords |
|
A custom report item is an extension to the Report Definition Language (RDL) that allows developers to add functionality that isn't natively supported in RDL or extend the functionality of existing controls. There are two main components to a custom report item: the run-time component and the design-time component. These components are implemented as [!INCLUDEdnprdnshort] assemblies, and can be written in any CLS-compliant language.
The run-time component for a custom report item is called by the report processor at run time. The run-time component accepts data passed by the report processor at run time, processes this data, and returns an image containing the rendered custom report item.
:::image type="content" source="../../reporting-services/custom-report-items/media/customreportitemrun-timecomponentarchitecture.gif" alt-text="Diagram of a custom report item run-time component.":::
The design-time component allows the custom report item to be defined and manipulated in the Report Designer interface in [!INCLUDEvsprvs]. The design-time component consists of several subcontrols that control the appearance and properties of the custom report item in the design environment.
:::image type="content" source="../../reporting-services/custom-report-items/media/customreportitemdesign-timecomponentarchitecture.gif" alt-text="Diagram of a custom report item design-time component.":::