Using Send Mail Message Functionality in Native Blazor Report Viewer

The native Blazor Report Viewer provides the capability to send the currently displaued report in the specified document format with an e-mail message.

Enabling the send mail message functionality

By default, the send mail message button is hidden. This is because the SendMailMessage (or the respective method for ServiceStack, ASP.NET Core, etc.) should be implemented first, so that the e-mail messages can be send server-side.

Web browsers cannot initiate the sending of e-mail messages containing attachments as a security measure. More information on how implement the necessary server-side code is available at Implement Send Mail Message.

Once ready, the send mail message toolbar button can be enabled throug the EnableSendEmail initialization option.

<ReportViewer 
...
EnableSendEmail="false" />

Send Mail Message Dialog

The Send Mail Message dialog is a Telerik Blazor UI Window widget, that stays on top of the report viewer.

Pre-configuring the Send Mail Message Dialog Settings

The settings are be populated from a SendEmailDialogSettings tag, that sits inside the ReportViewerSettings parent tag. The values are used only for initial population of the fields. Two-way binding is not supported for those settings.

Markup Example

<ReportViewer
    ServiceUrl="/api/reports"
    @bind-ReportSource="@ReportSource"
    EnableSendEmail="true">
    <ReportViewerSettings>
        <SendEmailDialogSettings
            From="[e-mail]"
            To="[e-mail]"
            Cc="Cc"
            Subject=""
            Body=""
            Format="CSV">
        </SendEmailDialogSettings>
    </ReportViewerSettings>
</ReportViewer>

Setting Fields

• From (Required) - E-mail address used for the MailMessage FROM value.
• To (Required) - E-mail address used for the MailMessage TO value.
• CC (Optional) - E-mail address used for the MailMessage CC value.
• Subject (Optional) - The MailMessage subject.
• Body (Optional) - The MailMessage body.
• Format - If empty, or not present in the list of supported formats by the report, the first available format from the list is chosen instead. Uses the non-localized values, such as PDF, CSV etc.

See Also

• Implement Send Mail Message