Forem: GPManuel

Send emails, with html template, from Xamarin.Forms

GPManuel — Tue, 28 Mar 2023 11:44:12 +0000

Generally, to send an email, if this is not the nature of our application, we fall back to a third party APP that by default our device uses for this purpose.

We do this using Xamarin.Essentials and the Email class, which allows an application to open the default email application with specified information including subject, body and recipients (TO, CC, BCC).

In this post we are going to show how to send emails from our Xamarin.Forms shared project (PCL). These emails, to give them a better appearance, we will format them using an HTML template.

For our case we are going to imagine that we want to send a notification about the user's activity, without the user having to intervene.

We could facilitate the writing of an email to the user through a view where we collect all the data and then generate the email from the backend. But that is not the goal of this post.

The emails will be sent thanks to the System.Net.Mail namespace, through SMTP protocol.

HTML template:

First we will add the HTML template to our project:



<html xmlns="http://www.w3.org/1999/xhtml">   
<head>  
    <title></title>  
</head>   
<body>    
    <table>   
        <tr>   
            <td>  
                <br />  
                <br />   
                <div style="border-top:3px solid #22BCE5"> </div>   
                <span style="font-family:Arial;font-size:10pt">  

Hello <b>{UserName}</b>,<br /><br />    

{message}  

<br /><br />    
Thanks<br />    

</span>    
            </td>    
        </tr>    
    </table>    
</body>    
</html>

In the properties of this resource, to make use of it, it is essential to mark the Compilation Action as "Embedded Resource". (Build Action: EmbeddedResource).

Loading template and substituting variables

When loading the template to read it, substitute the variables and send the content via SMTP, it is possible that we have problems to indicate the path. In another project we would write the absolute path, but we have to think that this application will be running on an Android device. So, if we want to perform this action from our shared project we will use the Xamarin.Forms File Control.

Therefore we will locate the resource as follows:



 var assembly = typeof(App).GetTypeInfo().Assembly;
 Stream stream = assembly.GetManifestResourceStream("Namespace.Folder.EmailTemplate.html");

In the template we can introduce variables between braces {}, to substitute them for the content we want.

Later we will use StreamReader, passing it the Stream, to read the template and substitute the variables for our content:



string body = string.Empty;
using (StreamReader reader = new StreamReader(stream))
{
    body = reader.ReadToEnd();
}
body = body.Replace("{UserName}", user);
body = body.Replace("{message}", message);

This way we would already have the body of our email in HTML format.

Send email

We will simply create a new method to send the email through SMTP:



public void SendEmail(string asunto, string mensaje)

        {


              try

              {

                  MailMessage mail = new MailMessage();

                  SmtpClient SmtpServer = new SmtpClient("smtp.office365.com");

              mail.From = new MailAddress("emisor@mail.com");
              mail.To.Add("receptor@mail.com");
              mail.Subject = asunto;
              mail.Body = mensaje;
              mail.IsBodyHtml = true;

              SmtpServer.Port = 587;
              SmtpServer.Host = "smtp.office365.com";
              SmtpServer.EnableSsl = true;
              SmtpServer.UseDefaultCredentials = false;
              SmtpServer.Credentials = new System.Net.NetworkCredential("emisor@mail.com", "password");

              SmtpServer.Send(mail);
          }
          catch (Excepción ex)
          {
              DisplayAlert("Error", ex.Message, "OK");  
          }
    }

Spanish post:

Enviar emails, con plantilla html, desde Xamarin.Forms

References:

Xamarin.Forms - Send Email Using SMTP

Send Email with HTML Templates using C#
Sending Email With HTML Template

File control

Enviar emails, con plantilla html, desde Xamarin.Forms

GPManuel — Fri, 19 Mar 2021 18:34:23 +0000

Generalmente, para mandar un correo electrónico, si esta no es la naturaleza de nuestra aplicación, recurrimos a una tercera APP que por defecto use nuestro dispositivo para este fin.

Esto lo hacemos mediante Xamarin.Essentials y la clase Email, que permite que una aplicación abra la aplicación de correo electrónico predeterminada con información especificada incluido el asunto, el cuerpo y los destinatarios (PARA, CC, CCO).

En esta entrada vamos a mostrar como enviar emails desde nuestro proyecto compartido(PCL) de Xamarin.Forms. Estos emails, para otorgarles una mejor apariencia, los formatearemos ayudándonos de una plantilla HTML.

Para nuestro caso vamos a imaginar que queremos enviar una notificación sobre la actividad del usuario, sin que este tenga que intervenir.

Podríamos facilitar la redacción de un email para el usuario a través de una vista donde recojamos todos los datos y luego generásemos el email desde backend. Pero no es el objetivo de esta entrada.

Los emails los enviaremos gracias al espacio de nombre System.Net.Mail, mediante protocolo SMTP.

Plantilla HTML:

En primer lugar añadiremos la plantilla HTML a nuestro proyecto:



<html xmlns="http://www.w3.org/1999/xhtml">   
<head>  
    <title></title>  
</head>   
<body>    
    <table>   
        <tr>   
            <td>  
                <br />  
                <br />   
                <div style="border-top:3px solid #22BCE5"> </div>   
                <span style="font-family:Arial;font-size:10pt">  

Hello <b>{UserName}</b>,<br /><br />    

{message}  

<br /><br />    
Thanks<br />    

</span>    
            </td>    
        </tr>    
    </table>    
</body>    
</html>

En las propiedades de este recurso, para hacer uso de el, es fundamental marcar la Acción de Compilación como "Recurso incrustado" (Build Action: EmbeddedResource).

Cargar plantilla y sustituir variables

A la hora de cargar la plantilla para leerla, sustituir las variables y mandar el contenido vía SMTP, es posible que tengamos problemas para indicar la ruta. En otro proyecto escribiríamos la ruta absoluta, pero hemos de pensar que esta aplicación estará corriendo en un dispositivo Android. Por lo que, si queremos realizar esta acción desde nuestro proyecto compartido haremos uso del Control de archivos de Xamarin.Forms.

Por lo tanto localizaremos el recurso del siguiente modo:



 var assembly = typeof(App).GetTypeInfo().Assembly;
 Stream stream = assembly.GetManifestResourceStream("EspacioDeNombres.Carpeta.EmailTemplate.html");

En la plantilla podemos introducir variables entre llaves {}, para sustituirlas por el contenido que deseemos.

Posteriormente usaremos StreamReader, pasándole el Stream, para leer la plantilla y sustituir las variables por nuestro contenido:



string body = string.Empty;
using (StreamReader reader = new StreamReader(stream))
{
    body = reader.ReadToEnd();
}
body = body.Replace("{UserName}", usuario);
body = body.Replace("{message}", mensaje);

De este modo ya tendríamos el cuerpo de nuestro email en formato HTML.

Enviar email

Sencillamente nos quedará crear un nuevo método que envíe el email a través de SMTP:



public void SendEmail(string asunto, string mensaje)
        {            
              try
              {
                  MailMessage mail = new MailMessage();
                  SmtpClient SmtpServer = new SmtpClient("smtp.office365.com");

                  mail.From = new MailAddress("emisor@mail.com");
                  mail.To.Add("receptor@mail.com");
                  mail.Subject = asunto;
                  mail.Body = mensaje;
                  mail.IsBodyHtml = true;

                  SmtpServer.Port = 587;
                  SmtpServer.Host = "smtp.office365.com";
                  SmtpServer.EnableSsl = true;
                  SmtpServer.UseDefaultCredentials = false;
                  SmtpServer.Credentials = new System.Net.NetworkCredential("emisor@mail.com", "password");

                  SmtpServer.Send(mail);
              }
              catch (Exception ex)
              {
                  DisplayAlert("Error", ex.Message, "OK");  
              }
        }

Espero que os ayude este post y sirva para contribuir a la comunidad hispano parlante.

Un saludo.

Artículo en inglés:

Send emails, with html template, from Xamarin.Forms

Referencias:

Xamarin.Forms - Send Email Using SMTP

Send Email with HTML Templates using C#
Sending Email With HTML Template

Control de archivos