Thursday, October 24, 2013

Create dynamic content using Razor templates


This article is explaining the usage of Razor template and effectiveness of these templates.

Let's consider one scenario, when you have to send emails to different users with dynamic data which is different for different users. Example shown below is a basic example. Think of some complex scenario where plenty of data need to be changed and also require some styling.

To start work on one simple example, right click on your website folder and create a new blank @view. Name it as "Useremail.cshtml". Paste the mentioned code there.

Useremail.cshtml

   <html>
   <body style="font-familyArialfont-sizesmaller">
   <p>Dear @Model.Name,</p>
    <p>A new account has been created for you to access Application with                            username: <b>@Model.Username </b></p>
    <p>You can access the application at @Model.AppUrl.</p>
    <p>Your password will be sent to you in a following email.    </p>
    <p>Thank you,</br>
       Cleansheet Team.
    </p>
    </body>
    </html>


Explanation: The Useremail.cshtml is Razor template file which is having dynamic html. The variable which need to be dynamic, we can give them as @Model.variable_name. ( For example: @Model.Name )

Next step is to create Controller which will assign the dynamic values, given in Razor template.

Controller.cs

       var userTemplate = File.ReadAllText(AppDomain.CurrentDomain.BaseDirectory +                                     @"Views\Email\Username.cshtml");

       dynamic userObj = new { Name = "Sumit Bajaj", Username = "sbajaj", AppUrl =                                  Request.RequestUri.GetLeftPart(UriPartial.Authority) };

       string userMsg = Razor.Parse(userTemplate, userObj);
       Email.Send(user.Email, "Your user name for the Application", userMsg);


Explanation: File.ReadAllText is reading the template file from current base directory. userObj is dynamic object  which is being populated with variables we defined in template file.

Line [string userMsg = Razor.Parse(userTemplate, userObj);] is filling the userObj data in userTemplate (Razor template). Next line is sending email to user with dynamic data populated.


Razor class is part of RazorEngine assembly which can be downloaded from Download RazorEngine Assembly. You can add reference of this assembly in your website and use it.



~~ Happy Coding ~~