Платформа .NET обладает очень удобным встроенным средством для генерации HTML — движок представлений Razor. Большинство ASP.NET разработчиков хорошо знакомы с его возможностями, однако использование его возможностей для генерации HTML кода писем электронной почты не очевидно для начинающих разработчиков.
В данной статье я хочу рассказать о созданном мною комплексе пакетов, упрощающих использование движка представлений Razor для для генерации HTML кода писем электронной почты. Генерировать HTML код писем будем используя библиотеку ServicesLibrary.RazorViewRendering, для отправки писем электронной почты возьмем библиотеку ServicesLibrary.Email.
Подключим сервисы в приложение (файл Sturtup.cs):
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
public void ConfigureServices(IServiceCollection services) { var emailOptions = Configuration.GetSection("EmailServiceOptions"); services.AddEmailService(new EmailOptions { Email = emailOptions.GetValue<string>("Email"), Password = emailOptions.GetValue<string>("Password"), Host = emailOptions.GetValue<string>("Host"), Port = emailOptions.GetValue<int>("Port"), EnableSSL = emailOptions.GetValue<bool>("SSL") }); services.AddViewRenderer(); services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); } |
Для подключения сервиса отправки электронных писем необходимо задать ему настройки электронной почты, которая будет использоваться для отправки писем, в данном случаи настройки были взяты из конфигурации приложения.
РЕКОМЕНДУЕМ:
Преобразование страницы Razor в строку
Для генерации HTML письма необходимо создать страницу представления и модель данных, в данном случаи была использована простейшая модель данных, представленная ниже:
|
1 2 3 4 5 |
public class HelloWorldModel { public string Name { get; set; } public string Text { get; set; } } |
Модели данных HelloWorldModel соответствует простейшее представление HelloWorldModel.cshtml:
|
1 2 3 4 5 |
@model ServicesLibrarySample.Models.HelloWorldModel <h1 style="text-align:center;color:darkorange;">Hello @(Model.Name)</h1> <h4 style="text-align:center;color:darkgreen;">Hello @(Model.Text)</h4> |
Генерацию HTML письма и его отправку осуществим с использованием страницы RazorPages:
Модель страницы имеет вид:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
public class IndexModel : PageModel { private readonly IRazorViewToStringRenderer _renderer; private readonly IEmailService _emailService; public IndexModel( IRazorViewToStringRenderer renderer, IEmailService emailService) { _renderer = renderer; _emailService = emailService; } [Display(Name="Name")] [BindProperty] public string Name { get; set; } [Display(Name = "Text")] [BindProperty] public string Text { get; set; } [Display(Name = "Email")] [BindProperty] public string Email { get; set; } public IActionResult OnGet() { return Page(); } public async Task<IActionResult> OnPost() { var message = await _renderer.RenderViewToStringAsync( viewName: "/wwwroot/Pages/HelloWorld.cshtml", model: new HelloWorldModel { Name = Name, Text = Text } ); await _emailService.SendEmailAsync( subject: "HelloWorld", message: message, IsBodyHTML: true, emails: Email); return Page(); } } |
При нажатии на кнопку происходит пост запрос на сервер, в результате чего вызывается метод OnPost. В этом методе происходит генерация HTML кода письма, исходя из заполненных полей в форме:
|
1 2 3 4 5 6 7 8 |
var message = await _renderer.RenderViewToStringAsync( viewName: "/wwwroot/Pages/HelloWorld.cshtml", model: new HelloWorldModel { Name = Name, Text = Text } ); |
Далее строка передается на отправку, для этого используется сервис отправки электронной почты, подключенный и настроенный ранее:
|
1 2 3 4 5 |
await _emailService.SendEmailAsync( subject: "HelloWorld", message: message, IsBodyHTML: true, emails: Email); |
В результате на почты пришло письмо следующего вида:
Спасибо за внимание, надеюсь созданные мною библиотеки будут полезны.
