ReportDesignerBase.DocumentOpenFailed Event
Occurs every time an attempt to load a report to a designer document fails.
Namespace: DevExpress.Xpf.Reports.UserDesigner
Assembly: DevExpress.Xpf.ReportDesigner.v21.2.dll
NuGet Package: DevExpress.Wpf.Reporting
Declaration
Event Data
The DocumentOpenFailed event's data class is ReportDesignerDocumentLoadFailedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Document | Gets the report document currently being processed. Inherited from ReportDesignerDocumentOperationFailedEventArgs. |
| 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. |
| 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. |
| ShowOpenFileDialogToSelectNewSource | Gets or sets a value that specifies whether to invoke the Open File dialog to select another report for loading to the designer document. |
| Source | Gets an object that raised the event. |
Remarks
Handle the DocumentOpenFailed event to respond to a failure to load a report to a designer document.
The current designer document is specified by the ReportDesignerDocumentOperationFailedEventArgs.Document property of the event parameter. Use the Exception property to get the exception that caused the failure. Enable the ShowOpenFileDialogToSelectNewSource property to invoke the Open File dialog to select another report for loading to the designer document. The event parameter’s properties also allow you to specify the error description, whether to show the error message, etc.