Blazorise Reporting: API Reference

Explore the API reference for Blazorise Reporting components, report definitions, state, data sources, layout elements, and toolbar commands.

For examples and usage guidance, see the Reporting documentation.

API

Parameters

Report

ParameterDefaultType
AllowBandCollapsetruebool

Enables collapsing and expanding bands in the designer rail.
BandModeClassicReportBandMode

Band presentation used when constructing a report from declarative content. Persisted definitions retain their configured value.
Possible values:RailSeparatorCompactClassic
ChildContentnullRenderFragment

Declarative report content used as the initial report definition.
Datanullobject

Default data source object or enumerable used when no explicit ReportDataSource is declared.
DefaultPreviewFormatnullReportPreviewFormat?

Preview format selected when preview mode is first opened. Must be enabled in PreviewFormats.
DefinitionnullReportDefinition

Persisted report definition copied into the designer working state.
DefinitionModenullReportDefinitionMode?

Controls how declarative child content is used with persisted definitions.
DisableImageUploadProgressReportfalsebool

Disables image upload progress callbacks.
Editablefalsebool

Defines whether the report can be edited using the interactive designer.
ElementNavigationModeElementAndCellReportElementNavigationMode

Defines how report elements participate in keyboard navigation when constructing a report from declarative content. Persisted definitions retain their configured value.
Possible values:NoneElementCellElementAndCell
ElementPluginsnullIEnumerable<IReportElementPlugin>

Custom report element plugins available only to this report instance. The collection is read during initialization.
ImageAccept"image/png, image/jpeg"string

A comma-separated list of image MIME types accepted by the image upload dialog.
ImageMaxSize1024 * 1024 * 5long

Maximum image size in bytes.
ImageUploadSegmentFetchTimeoutTimeSpan.FromMinutes( 1 )TimeSpan

Specifies the segment fetch timeout when uploading the image.
LocalizersnullReportLocalizers

Custom localizers used by the report designer and viewer.
MaxUploadImageChunkSize20 * 1024int

Specifies the max chunk size when uploading the image.
ModenullReportMode?

Externally controlled design or preview mode.
PreviewFormatnullReportPreviewFormat?

Externally controlled preview format. Must be either HTML or PDF.
PreviewFormatsnullReportPreviewFormat?

Preview formats available for this report. None disables preview.
ShowBandDataSourcetruebool

Shows data source names in band labels when available.
ShowCollisionWarningstruebool

Defines collision warning visibility when constructing a report from declarative content. Persisted definitions retain their configured value.
ShowCursorGuidesfalsebool

Defines cursor guide visibility when constructing a report from declarative content. Persisted definitions retain their configured value.
ShowFineRulerTicksfalsebool

Defines fine ruler tick visibility when constructing a report from declarative content. Persisted definitions retain their configured value.
ShowPageTabstruebool

Shows page navigation above the report designer surface.
ShowRulerstruebool

Defines ruler visibility when constructing a report from declarative content. Persisted definitions retain their configured value.
ShowStatusBartruebool

Shows the status bar below the report designer or preview surface.
ShowToolbartruebool

Shows the report toolbar above the designer or viewer surface.
UploadImagetruebool

Enables image upload from Image element source properties.

ReportViewer

ParameterDefaultType
AllowDownloadtruebool

Enables download commands in the viewer toolbar.
AllowPrinttruebool

Enables print commands in the viewer toolbar.
DefaultPreviewFormatHtmlReportPreviewFormat

Preview format selected when preview mode is opened. Must be enabled in PreviewFormat.
Possible values:NoneHtmlPdf
PdfPreviewTemplatenullRenderFragment<ReportPdfPreviewContext>

Template used to render generated PDF previews.
PreviewFormatHtmlReportPreviewFormat

Preview formats offered by the report viewer. None disables preview.
Possible values:NoneHtmlPdf

ReportPage

ParameterDefaultType
ChildContentnullRenderFragment

Declarative report bands placed on this page.
Heightnulldouble?

Explicit page height in the configured measurement unit.
MarginBottom0double

Bottom printable page margin in the configured measurement unit.
MarginLeft0double

Left printable page margin in the configured measurement unit.
MarginRight0double

Right printable page margin in the configured measurement unit.
MarginTop0double

Top printable page margin in the configured measurement unit.
MeasurementUnitCentimeterReportMeasurementUnit

Unit used by the declarative page dimensions and margins.
Possible values:PointInchCentimeterMillimeter
Name—string

Friendly page name shown in the designer.
OrientationPortraitReportOrientation

Page orientation applied to the selected size.
Possible values:PortraitLandscape
SizeA4ReportPageSize

Named page size used when explicit dimensions are not supplied.
Possible values:A4LetterCustomA3A5Legal
Widthnulldouble?

Explicit page width in the configured measurement unit.

ReportText

ParameterDefaultType
AppearancenullReportAppearanceDefinition

Fill and opacity settings applied to the element.
BackgroundColornullReportColor

Background color applied to the element.
Boldfalsebool

Enables bold text rendering.
BordernullReportBorderDefinition

Border settings applied around the element.
BorderColornullReportColor

Border color applied to the element.
BorderRadiusnulldouble?

Border radius applied to the element corners.
BorderStyleReportBorderStyle.DefaultReportBorderStyle

Border style applied around the element.
Possible values:DefaultSolidDashedDotted
BorderWidthnulldouble?

Border width applied around the element.
CanGrowfalseReportValue<bool>

Allows text content to expand the element vertically when rendered.
Class—string

Additional CSS classes applied to the element.
FontColornullReportColor

Text color applied to the element.
FontFamily—string

Font family applied to text rendered by the element.
FontSizenulldouble?

Font size applied to text rendered by the element.
Height18double

Element height in points.
Italicfalsebool

Enables italic text rendering.
Name—string

Friendly element name shown in the designer.
Opacitynulldouble?

Element opacity from 0 to 1.
ShowCollisionWarningstruebool

Indicates whether the element participates in designer collision warnings.
SnapToGridnullbool?

Overrides the designer-level snap-to-grid behavior for this element. A null value inherits the designer setting.
Style—string

Inline style applied to the element.
SuppressfalseReportValue<bool>

Prevents the element from being edited on the designer surface and rendered in preview output.
Text—string

Text content rendered by the element.
TextAlignmentDefaultTextAlignment

Text alignment applied inside the element box.
Possible values:DefaultStartEndCenterJustified
Underlinefalsebool

Enables underline text rendering.
VerticalAlignmentDefaultVerticalAlignment

Vertical text alignment applied inside the element box.
Possible values:DefaultBaselineTopMiddleBottomTextTopTextBottom
Width90double

Element width in points.
X0double

Horizontal position within the containing report container, in points.
Y0double

Vertical position within the containing report container, in points.

ReportField

ParameterDefaultType
AggregateFunctionnullReportAggregateFunction?

Aggregate function applied when this field is rendered as a summary.
AppearancenullReportAppearanceDefinition

Fill and opacity settings applied to the element.
BackgroundColornullReportColor

Background color applied to the element.
Boldfalsebool

Enables bold text rendering.
BordernullReportBorderDefinition

Border settings applied around the element.
BorderColornullReportColor

Border color applied to the element.
BorderRadiusnulldouble?

Border radius applied to the element corners.
BorderStyleReportBorderStyle.DefaultReportBorderStyle

Border style applied around the element.
Possible values:DefaultSolidDashedDotted
BorderWidthnulldouble?

Border width applied around the element.
CanGrowfalseReportValue<bool>

Allows text content to expand the element vertically when rendered.
Class—string

Additional CSS classes applied to the element.
Field—string

Field name or expression resolved against the current data item.
FontColornullReportColor

Text color applied to the element.
FontFamily—string

Font family applied to text rendered by the element.
FontSizenulldouble?

Font size applied to text rendered by the element.
FormatnullReportFormatDefinition

Format applied to the resolved field value.
Height18double

Element height in points.
Italicfalsebool

Enables italic text rendering.
Name—string

Friendly element name shown in the designer.
Opacitynulldouble?

Element opacity from 0 to 1.
ShowCollisionWarningstruebool

Indicates whether the element participates in designer collision warnings.
SnapToGridnullbool?

Overrides the designer-level snap-to-grid behavior for this element. A null value inherits the designer setting.
Style—string

Inline style applied to the element.
SuppressfalseReportValue<bool>

Prevents the element from being edited on the designer surface and rendered in preview output.
TextAlignmentDefaultTextAlignment

Text alignment applied inside the element box.
Possible values:DefaultStartEndCenterJustified
Underlinefalsebool

Enables underline text rendering.
VerticalAlignmentDefaultVerticalAlignment

Vertical text alignment applied inside the element box.
Possible values:DefaultBaselineTopMiddleBottomTextTopTextBottom
Width90double

Element width in points.
X0double

Horizontal position within the containing report container, in points.
Y0double

Vertical position within the containing report container, in points.

ReportImage

ParameterDefaultType
AppearancenullReportAppearanceDefinition

Fill and opacity settings applied to the element.
BackgroundColornullReportColor

Background color applied to the element.
BordernullReportBorderDefinition

Border settings applied around the element.
BorderColornullReportColor

Border color applied to the element.
BorderRadiusnulldouble?

Border radius applied to the element corners.
BorderStyleReportBorderStyle.DefaultReportBorderStyle

Border style applied around the element.
Possible values:DefaultSolidDashedDotted
BorderWidthnulldouble?

Border width applied around the element.
CanGrowfalseReportValue<bool>

Allows text content to expand the element vertically when rendered.
Class—string

Additional CSS classes applied to the element.
FitReportImageFit.DefaultReportImageFit

Defines how the image fits inside the element bounds.
Possible values:DefaultContainCoverFillNoneScaleDown
Height18double

Element height in points.
Name—string

Friendly element name shown in the designer.
Opacitynulldouble?

Element opacity from 0 to 1.
ShowCollisionWarningstruebool

Indicates whether the element participates in designer collision warnings.
SnapToGridnullbool?

Overrides the designer-level snap-to-grid behavior for this element. A null value inherits the designer setting.
Source—string

Image source URL or data URI rendered by the element.
Style—string

Inline style applied to the element.
SuppressfalseReportValue<bool>

Prevents the element from being edited on the designer surface and rendered in preview output.
Text—string

Alternate text associated with the image element.
Width90double

Element width in points.
X0double

Horizontal position within the containing report container, in points.
Y0double

Vertical position within the containing report container, in points.

ReportLine

ParameterDefaultType
AppearancenullReportAppearanceDefinition

Fill and opacity settings applied to the element.
BackgroundColornullReportColor

Background color applied to the element.
BordernullReportBorderDefinition

Border settings applied around the element.
BorderColornullReportColor

Border color applied to the element.
BorderRadiusnulldouble?

Border radius applied to the element corners.
BorderStyleReportBorderStyle.DefaultReportBorderStyle

Border style applied around the element.
Possible values:DefaultSolidDashedDotted
BorderWidthnulldouble?

Border width applied around the element.
CanGrowfalseReportValue<bool>

Allows text content to expand the element vertically when rendered.
Class—string

Additional CSS classes applied to the element.
Height18double

Element height in points.
Name—string

Friendly element name shown in the designer.
Opacitynulldouble?

Element opacity from 0 to 1.
OrientationHorizontalOrientation

Line orientation within the element bounds.
Possible values:HorizontalVertical
ShowCollisionWarningstruebool

Indicates whether the element participates in designer collision warnings.
SnapToGridnullbool?

Overrides the designer-level snap-to-grid behavior for this element. A null value inherits the designer setting.
Style—string

Inline style applied to the element.
SuppressfalseReportValue<bool>

Prevents the element from being edited on the designer surface and rendered in preview output.
Thicknessnulldouble?

Line stroke thickness in points.
Width90double

Element width in points.
X0double

Horizontal position within the containing report container, in points.
Y0double

Vertical position within the containing report container, in points.

ReportRectangle

ParameterDefaultType
AppearancenullReportAppearanceDefinition

Fill and opacity settings applied to the element.
BackgroundColornullReportColor

Background color applied to the element.
BordernullReportBorderDefinition

Border settings applied around the element.
BorderColornullReportColor

Border color applied to the element.
BorderRadiusnulldouble?

Border radius applied to the element corners.
BorderStyleReportBorderStyle.DefaultReportBorderStyle

Border style applied around the element.
Possible values:DefaultSolidDashedDotted
BorderWidthnulldouble?

Border width applied around the element.
CanGrowfalseReportValue<bool>

Allows text content to expand the element vertically when rendered.
Class—string

Additional CSS classes applied to the element.
Height18double

Element height in points.
Name—string

Friendly element name shown in the designer.
Opacitynulldouble?

Element opacity from 0 to 1.
ShowCollisionWarningstruebool

Indicates whether the element participates in designer collision warnings.
SnapToGridnullbool?

Overrides the designer-level snap-to-grid behavior for this element. A null value inherits the designer setting.
Style—string

Inline style applied to the element.
SuppressfalseReportValue<bool>

Prevents the element from being edited on the designer surface and rendered in preview output.
Width90double

Element width in points.
X0double

Horizontal position within the containing report container, in points.
Y0double

Vertical position within the containing report container, in points.

ReportPageBreak

ParameterDefaultType
AppearancenullReportAppearanceDefinition

Fill and opacity settings applied to the element.
BackgroundColornullReportColor

Background color applied to the element.
BordernullReportBorderDefinition

Border settings applied around the element.
BorderColornullReportColor

Border color applied to the element.
BorderRadiusnulldouble?

Border radius applied to the element corners.
BorderStyleReportBorderStyle.DefaultReportBorderStyle

Border style applied around the element.
Possible values:DefaultSolidDashedDotted
BorderWidthnulldouble?

Border width applied around the element.
CanGrowfalseReportValue<bool>

Allows text content to expand the element vertically when rendered.
Class—string

Additional CSS classes applied to the element.
Height18double

Element height in points.
Name—string

Friendly element name shown in the designer.
Opacitynulldouble?

Element opacity from 0 to 1.
ShowCollisionWarningstruebool

Indicates whether the element participates in designer collision warnings.
SnapToGridnullbool?

Overrides the designer-level snap-to-grid behavior for this element. A null value inherits the designer setting.
Style—string

Inline style applied to the element.
SuppressfalseReportValue<bool>

Prevents the element from being edited on the designer surface and rendered in preview output.
Width90double

Element width in points.
X0double

Horizontal position within the containing report container, in points.
Y0double

Vertical position within the containing report container, in points.

ReportTableColumn

ParameterDefaultType
Field—string

Field name rendered by cells in this column.
FormatnullReportFormatDefinition

Format applied to column values.
Title—string

Header text displayed for the table column.
Width90double

Column width in points.

ReportTableRow

ParameterDefaultType
ChildContentnullRenderFragment

Cells declared inside the table row.
Height24double

Row height in points.

ReportTableCell

ParameterDefaultType
ChildContentnullRenderFragment

Elements declared inside the table cell.
ColumnSpan1int

Number of columns spanned by the cell.
RowSpan1int

Number of rows spanned by the cell.

ReportDataSources

ParameterDefaultType
ChildContentnullRenderFragment

Data source components declared for the parent report.

ReportDataSource

ParameterDefaultType
Datanullobject

Object or enumerable exposed to the report designer and preview renderer, including nested objects and collections.
Name"Default"string

Name used by report bands and fields to reference this data source.
ProviderType—string

Data source provider type used to resolve schema and runtime data.
SchemanullReportDataSourceSchema

Field schema exposed by providers that do not use a reflected object model.
Settings[]Dictionary<string, object>

Provider-specific settings stored with the report definition.

ReportObjectDataSource

ParameterDefaultType
Datanullobject

Object or enumerable exposed to the report designer and preview renderer, including nested objects and collections.
Name"Default"string

Name used by report bands and fields to reference this object data source.
SchemanullReportDataSourceSchema

Optional field schema used instead of schema inferred from the object model.

ReportFormulaFields

ParameterDefaultType
ChildContentnullRenderFragment

Formula field components declared for the parent report.

ReportFormulaField

ParameterDefaultType
Formula—string

Formula expression evaluated when the field is rendered.
Name—string

Formula field name shown in the field explorer and used by expressions.

ReportRunningTotals

ParameterDefaultType
ChildContentnullRenderFragment

Running total field components declared for the parent report.

ReportRunningTotal

ParameterDefaultType
AggregateFunctionSumReportAggregateFunction

Summary operation used to update the running total value.
Possible values:CountSumAverageMinimumMaximum
DataSource—string

Data source or path that provides the records being accumulated.
EvaluateFormula—string

Boolean formula used when EvaluateMode is set to Formula.
EvaluateModeEveryRecordReportRunningTotalEvaluateMode

Determines whether every record or only formula-matching records are accumulated.
Possible values:EveryRecordFormula
Field—string

Field path summarized by the running total.
IdSystem.Guid.NewGuid().ToString( "N" )string

Stable identifier used by persisted report definitions.
Name—string

Running total field name shown in the field explorer and used by expressions.
ResetGroupId—string

Stable group section identifier used when ResetMode is set to Group.
ResetModeNeverReportRunningTotalResetMode

Determines when the accumulated value resets.
Possible values:NeverGroup

ReportToolbar

ParameterDefaultType
ButtonTemplatenullRenderFragment<ReportToolbarItemContext>

Template used to render command buttons in the report toolbar.
ChildContentnullRenderFragment

Toolbar items rendered by the report toolbar area.
HiddenCommandsnullIReadOnlyCollection<ReportCommand>

Commands omitted from the default report toolbar.
ShowDataSourceButtonstruebool

Shows the data source command buttons in the default report toolbar.
ShowEditButtonstruebool

Shows the edit command buttons in the default report toolbar.
ShowExportButtonstruebool

Shows the export command buttons in the default report toolbar.
ShowHistoryButtonstruebool

Shows the history command buttons in the default report toolbar.
ShowModeButtonstruebool

Shows the report mode buttons in the default report toolbar.
ShowPanesMenutruebool

Shows the panes menu in the default report toolbar when dock panes are available.
ShowPersistenceButtonstruebool

Shows the save and load buttons in the default report toolbar.

ReportOptions

ParameterDefaultType
AllowDownloadtruebool

Enables download commands in report viewers by default.
AllowPrinttruebool

Enables print commands in report viewers by default.
DefaultPreviewFormatHtmlReportPreviewFormat

Preview format selected when a report first enters preview mode. Must be enabled in PreviewFormats.
Possible values:NoneHtmlPdf
DefinitionModeSeedWhenEmptyReportDefinitionMode

Strategy used when declarative report markup and persisted definitions are both available.
Possible values:SeedWhenEmptyAlwaysUseDeclarativeUseDefinitionOnly
Editablefalsebool

Gets or sets whether reports can be edited using the interactive designer.
PreviewFormatsHtmlReportPreviewFormat

Preview formats available to report viewers by default. None disables preview.
Possible values:NoneHtmlPdf

ReportRenderOptions

ParameterDefaultType
DataSourcesnew Dictionary<string, object>( StringComparer.OrdinalIgnoreCase )IDictionary<string, object>

Gets or sets runtime data keyed by the data source names persisted in the report definition.
DefaultDatanullobject

Gets or sets fallback runtime data used by report expressions and a single object data source.
ElementPluginsnullIEnumerable<IReportElementPlugin>

Gets or sets custom report element plugins available only to this render operation.
Parametersnew Dictionary<string, object>( StringComparer.OrdinalIgnoreCase )IDictionary<string, object>

Gets or sets parameter values supplied to data source providers.

BaseReportElementRenderer

ParameterDefaultType
ContextnullReportElementRenderContext

Gets or sets the custom element render context.

BaseReportElementPropertiesEditor

ParameterDefaultType
ContextnullReportElementPropertiesContext

Gets or sets the custom element properties context.

Events

Report

EventType
BandModeChangedEventCallback<ReportBandMode>

Raised when the designer band presentation changes.
DefinitionChangedEventCallback<ReportDefinition>

Raised with a snapshot of the updated report definition.
ElementNavigationModeChangedEventCallback<ReportElementNavigationMode>

Raised when the report element navigation mode changes.
ImageUploadEventCallback<FileUploadEventArgs>

Raised when the image upload action is confirmed.
ImageUploadChangedEventCallback<FileChangedEventArgs>

Raised when the selected image changes.
ImageUploadEndedEventCallback<FileEndedEventArgs>

Raised when reading an image ends.
ImageUploadProgressedEventCallback<FileProgressedEventArgs>

Raised when image read progress changes.
ImageUploadStartedEventCallback<FileStartedEventArgs>

Raised when reading an image starts.
ImageUploadWrittenEventCallback<FileWrittenEventArgs>

Raised when an image chunk is read.
LoadRequestedFunc<Task<ReportDefinition>>

Handles requests to load a report definition.
ModeChangedEventCallback<ReportMode>

Raised when design or preview mode changes.
OperationFailedEventCallback<ReportOperationFailedEventArgs>

Raised when a report operation fails.
PdfProgressedEventCallback<ReportProgress>

Raised when the overall report PDF operation progress changes.
PreviewFormatChangedEventCallback<ReportPreviewFormat>

Raised when the preview format changes.
SaveRequestedFunc<ReportDefinition, Task>

Handles requests to save the current report definition.
ShowCollisionWarningsChangedEventCallback<bool>

Raised when collision warning visibility changes.
ShowCursorGuidesChangedEventCallback<bool>

Raised when cursor guide visibility changes.
ShowFineRulerTicksChangedEventCallback<bool>

Raised when fine-grained ruler tick visibility changes.
ShowRulersChangedEventCallback<bool>

Raised when designer ruler visibility changes.
ShowStatusBarChangedEventCallback<bool>

Raised when status bar visibility changes.

Methods

Report

MethodReturnParameters
CanExecuteCommandboolReportCommand command

No documentation available - no XML comment
No documentation available - no XML comment
ExecuteCommandTaskReportCommand command

No documentation available - no XML comment
No documentation available - no XML comment
GetDefinitionTask<ReportDefinition>—

Gets a copy of the current persistent report definition.
GetPdfDocumentTask<PdfDocumentDefinition>CancellationToken cancellationToken

Creates a PDF document definition from the current report state.
GetStateTask<ReportState>—

Gets the current interactive report designer state.
IsCommandActiveboolReportCommand command

No documentation available - no XML comment
No documentation available - no XML comment
LoadDefinitionTaskReportDefinition definition

Loads a persistent report definition.
LoadStateTaskReportState state

Loads an interactive report designer state.