ICustomReportItem Interface

Contains methods and properties to be implemented by custom report item run-time components.

Namespace:  Microsoft.ReportingServices.ReportRendering
Assembly:  Microsoft.ReportingServices.ProcessingCore (in Microsoft.ReportingServices.ProcessingCore.dll)

Syntax

'Declaration
Public Interface ICustomReportItem
'Usage
Dim instance As ICustomReportItem
public interface ICustomReportItem
public interface class ICustomReportItem
type ICustomReportItem =  interface end
public interface ICustomReportItem

The ICustomReportItem type exposes the following members.

Properties

  Name Description
Public property Action Infrastructure.
Public property CustomItem Sets the custom report item and associated data used by the custom report item run-time component to render a standard report item. Write-only.
Public property RenderItem Contains the rendered image of the custom report item.

Top

Methods

  Name Description
Public method Process Renders the custom report item and places it in the RenderItem property.

Top

Remarks

One instance of the class that implements ICustomReportItem is created during each report execution that contains any instances of the corresponding CustomReportItem type. For each instance of a CustomReportItem of the matching type that occurs in the report, CustomItem is set and then Process is called. Since the report server is multithreaded, the class that implements ICustomReportItem should avoid use of static member variables.

The custom report item class will not be installed if a failure occurs while creating the class. Any other failure will cause the entire report execution to fail.

For more information, please see Custom Report Items.