Xamarin.Forms - Send Mail Using Xamarin Essentials

Delpin Susai Raj

8y47.2k8100Article

8 Comments

Join the conversation! Your thoughts help the community grow.

Thibault Grisval7y ago
Hello sir,I would like to know if it was possible to manage the formatting of the email. For example if I add a field "first name" that the user must fill, how to make that in the mail, this first name appears like this: First name: Joe After the message is displayed normally. If you do not understand my request, tell me. Thank you so much Cordially Thibault
- Delpin Susai Raj7y ago
  Hello Thibault Grisval Yes it's possible please construct your email body content HTML refer following link https://code.msdn.microsoft.com/windowsdesktop/Sending-Emails-with-HTML-76e0a018
- Thibault Grisval7y ago
  Thank you sir for your help.But when I enter the code in mine, I get an error: Error CS1061 'EmailMessage' does not contain a definition for 'BodyHtml' and no accessible extension method 'BodyHtml' accepting a first argument of type 'EmailMessage' was found (using directive or an assembly reference is it being missing?) What should I do to solve this problem? You can find my code here: https://drive.google.com/drive/folders/1-W5Z5TgizcB7JS1aabGCwESQilUBbh3A?usp=sharing Thank you
Keith Phillips7y ago
Is there a way to add attachments?
- Delpin Susai Raj7y ago
  Keith Phillips Please check Official Document i attached Link https://docs.microsoft.com/en-us/xamarin/essentials/email?context=xamarin/android&tabs=android
Alain Natalini8y ago
Hi Delpin. I have to add the following string "Bundle bundle = null" into the OnCreate method in MainActivity.cs to fix the given error "CS0103 The name 'bundle' doesn't exist in the current context'. Can you verify about? Thanks.
- Delpin Susai Raj8y ago
  Alain Natalini i think this the problem please check compile version Target Android version for compiling must be 8.1, API level 27.
Abhishek Kumar8y ago
Very good article

Introduction

Xamarin.Forms code runs on multiple platforms - each of which has its own filesystem. This means that reading and writing files are most easily done using the native file APIs on each platform. Alternatively, embedded resources are a simpler solution to distribute data files with an app.

Xamarin.Essentials

Xamarin.Essentials plugin provides 20+ cross-platform APIs for mobile application development. Xamarin.Essentials API works with all Xamarin.Forms, Xamarin.Android, Xamarin.iOS, or UWP applications that can be accessed from shared code. Thanks to Xamarin.Essentials, developers can access every native platform API using C#. This plugin provides many APIs so initially, there is no need for more plugins for Xamarin. Xamarin.Essentials plugin impacts your app's minimum size.

Platform Support

Xamarin.Essentials supports platforms and operating systems,

Platform	Version
Android	4.4 (API 19) or earlier
iOS	10.0 or higher
UWP	10.0.16299.0 or earlier

Prerequisites

Visual Studio 2017(Windows or Mac)

Setting up a Xamarin.Forms Project

Start by creating a new Xamarin.Forms project. You’ll learn more by going through the steps yourself.

Choose the Xamarin.Forms App Project type under Cross-platform/App in the new project dialog.

Name your app, select “Use Portable Class Library” for shared code, and target both Android and iOS.

You probably want your project and solution to use the same name as your app. Put it in your preferred folder for projects and click create.

You now have a basic Xamarin.Forms app. Click the play button to try it out.

Setting up the User Interface

Go to MainPage.Xaml and write the following code.

MainPage.xaml

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:local="clr-namespace:XamarinEssentials"
x:Class="XamarinEssentials.MainPage">
<StackLayout>
<StackLayout HorizontalOptions="Center" VerticalOptions="Start">
<Image Margin="0,50,0,0" x:Name="imgBanner" Source="banner.png" ></Image>
<Image Margin="0,0,0,10" x:Name="imgXamarinEssential" Source="xamarinessential.png" ></Image>
<Label Margin="0,0,0,10" FontAttributes="Bold" FontSize="Large" TextColor="#CA6F1E" HorizontalTextAlignment="Center" Text="Mail"></Label>
<Entry x:Name="txtTo" Placeholder="[email protected]"> </Entry>
<Entry x:Name="txtSubject" Placeholder="Subject"> </Entry>
<Editor x:Name="txtBody" HeightRequest="50" > </Editor>
<Button x:Name="btnSend" Text="Send Mail" Clicked="btnSend_Clicked"/>
</StackLayout>
</StackLayout>
</ContentPage>

Add Xamarin Essentials

In this step, add Xamarin.Essentials to your project. You can install Xamarin.Essentials via NuGet, or you can browse the source code on GitHub.

Go to Solution Explorer and select your solution. Right-click and select "Manage NuGet Packages for Solution". Search "Xamarin.Essentials" and add Package. Remember to install it for each project (PCL, Android, iO, and UWP).

Xamarin.Essentials requires platform-specific setup

Android,

The following steps are necessary for Android,

Xamarin.Essentials support a minimum Android version of 4.4
Target Android version for compiling must be 8.1, API level 27.

In the Android project's MainActivity that is launched, Xamarin.Essentials must be initialized in the OnCreate method.

MainActivity.cs

Xamarin.Essentials.Platform.Init(this, bundle);

Xamarin.Essentials must receive any OnRequestPermissionsResult. Write the following code for runtime permission.

MainActivity.cs

public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults)
{
Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}

iOS

No additional setup required.

UWP

No additional setup required.

Limitation

It supports the devices only, not Simulator/Emulator

In this step, write the following code for sending mail.

MainPage.xaml.cs

using System.Threading.Tasks;
using Xamarin.Forms;
using Xamarin.Essentials;
namespace XamarinEssentials
{
public partial class MainPage : ContentPage
{
public MainPage()
{
InitializeComponent();
}
protected override void OnAppearing()
{
base.OnAppearing();
}
async void btnSend_Clicked(object sender, System.EventArgs e)
{
List<string> toAddress = new List<string>();
toAddress.Add(txtTo.Text);
await SendEmail(txtSubject.Text,txtBody.Text, toAddress);
}
public async Task SendEmail(string subject, string body, List<string> recipients)
{
try
{
var message = new EmailMessage
{
Subject = subject,
Body = body,
To = recipients,
};
await Email.ComposeAsync(message);
}
catch (FeatureNotSupportedException fbsEx)
{
// Email is not supported on this device
}
catch (Exception ex)
{
// Some other exception occurred
}
}
}
}

Click the play button to try it out.

I hope you have understood how to send mail Using Xamarin Essentials in Xamarin.Forms.

Thanks for reading. Please share comments and feedback.