EnableExternalImages Property

Article
02/26/2024

Version: Available or changed with runtime version 1.0.

Sets whether external images are allowed on a report.

Applies to

Report

Property Value

True if external images are allowed; otherwise, false. The default is false.

Syntax

EnableExternalImages = true;

Remarks

[NOTE] It applies to client report definition (RDLC) report layouts.

When you use the Visual Studio Report Designer for creating reports for the RoleTailored client, you can add images such as your company logo to a report. You can add either embedded or external images.

With an embedded image, the source file is compiled as part of the report. If a report only uses embedded images, then you can set the EnableExternalImages property to false. For an example of using embedded images, see How to add a Company Picture to a Report.
With an external image, the source file is stored outside of the report in a location that must be accessible from the RoleTailored client, such as on a file server or local computer. The image is referenced from the report and loads when the report opens. To use external images on a report, the EnableExternalImages property must be set to true.

Note

The EnableExternalImages property exposes the LocalReport.EnableExternalImages property of the Microsoft.ReportViewer.WebForms.LocalReport object, which is embedded in Dynamics 365 Business Central. The Microsoft.ReportViewer.WebForms.LocalReport object is part of the ReportViewer controls that are available in Visual Studio for adding reports to your application.

For information about how to add images using Visual Studio Report Designer, see Adding Images to a Report (Visual Studio Report Designer).

Security Considerations

Dynamics 365 Business Central cannot verify image sources and protect against malicious images or sources that may be harmful to your computer. You should set the EnableExternalImages property to true only if you can ensure that images on the report come from a trusted source.