Skip to main content

ReportDesignerBase.SubreportLoadFailed Event

Occurs when the attempt to load a subreport to the End-User Report Designer failed.

Namespace: DevExpress.Xpf.Reports.UserDesigner

Assembly: DevExpress.Xpf.ReportDesigner.v24.1.dll

NuGet Package: DevExpress.Wpf.Reporting

Declaration

public event EventHandler<ReportDesignerDocumentSubreportLoadFailedEventArgs> SubreportLoadFailed

Event Data

The SubreportLoadFailed event's data class is ReportDesignerDocumentSubreportLoadFailedEventArgs. The following properties provide information specific to this event:

Property Description
Document Gets the report designer document currently being processed.
ErrorMessage Gets or sets an error description displayed within an error message box. Inherited from OperationFailedEventArgs.
Exception Gets an exception that raised the corresponding event. Inherited from OperationFailedEventArgs.
ReportSourceUrl Specifies a URL of a report definition file (*.REPX) loaded as a subreport. Inherited from SubreportLoadFailedEventArgs.
Rethrow Gets or sets a value that specifies whether to throw an exception on a failure. Inherited from OperationFailedEventArgs.
ShowErrorMessage Gets or sets a value that specifies whether to display an error message box. Inherited from OperationFailedEventArgs.

Remarks

Handle the SubreportLoadFailed event to respond to a failure to load a subreport to the Report Designer.

The current designer document is specified by the Document property of the event parameter. The ReportSourceUrl property defines a URL of a report definition file (*.REPX) loaded as a subreport. Use the Exception property to get the exception that caused the failure. The event parameter’s properties also allow you to specify the error description, whether to show the error message, etc.

See Also