WebDocumentViewerBuilderBase<TSettings, TImpl, TModel>.Bind(String) Method
Retrieves a report and passes it to the reporting component.
Namespace: DevExpress.AspNetCore.Reporting.WebDocumentViewer
Assembly: DevExpress.AspNetCore.Reporting.v24.1.dll
NuGet Package: DevExpress.AspNetCore.Reporting
Declaration
Parameters
Name | Type | Description |
---|---|---|
reportUrl | String | A string that specifies the report to show in the reporting component. |
Returns
Type | Description |
---|---|
TImpl | A WebDocumentViewerBuilderBase<TSettings, TImpl, TModel> that can be used in method chaining to configure the component. |
Remarks
The Bind(string reportUrl)
method allows you to implement a custom logic to cache and reuse reports in order to consume less memory and improve performance.
The method is used as illustrated in the following code snippet:
@Html.DevExpress().WebDocumentViewer("DocumentViewer").Height("1000px").Bind("MyReport")
A string specified in this method is processed as follows:
The method checks for the IWebDocumentViewerReportResolver service implementation. If the service is available, the method queries the service to get the report instance by the specified report’s unique name. If the attempt succeeds, the XtraReport object is passed to the Document Viewer to render and display the report.
If the IWebDocumentViewerReportResolver service is unavailable, the string is passed to the IReportProvider service. If the service is available, the method queries the service to get the report instance by the specified report’s unique name.
If the IReportProvider service is unavailable, the string is passed to the ReportStorageWebExtension service.
One of the above services must be explicitly implemented and registered. Otherwise, the Bind(System.String)
method fails with an exception.
Tip
The recommended services are the IReportProvider for Document Viewer and Parameters Panel, or the ReportStorageWebExtension service for the Report Designer component.