How to use the email compose task for Windows Phone 8

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Use the email compose task to enable users to send email from your application. The task launches the email application and displays a new email message with the cursor in the To field and the software keyboard displayed. You can optionally specify recipients, a message subject, and a message body, which are prepopulated in the new message. You can also specify a code page for the new message. The message is sent only when the user presses the send button.

By using Launchers, you help provide a consistent user experience throughout the Windows Phone platform. For more information, see Launchers and Choosers for Windows Phone 8.

Warning

On Windows Phone Emulator, an exception occurs when using the email compose task. Test the email compose task on a physical device.

To use the email compose task

1. Add the following statement to your code.

   using Microsoft.Phone.Tasks;
   

   Imports Microsoft.Phone.Tasks
   

2. Add the following code to your application wherever you need it, such as in a button click event. To test this procedure, you can put the code in the page constructor. This is the code to launch the task.

   EmailComposeTask emailComposeTask = new EmailComposeTask();
   
   emailComposeTask.Subject = "message subject";
   emailComposeTask.Body = "message body";
   emailComposeTask.To = "recipient@example.com";
   emailComposeTask.Cc = "cc@example.com";
   emailComposeTask.Bcc = "bcc@example.com";
   
   emailComposeTask.Show();
   

   Dim emailComposeTask as EmailComposeTask= new EmailComposeTask()
   
   emailComposeTask.Subject = "message subject"
   emailComposeTask.Body = "message body"
   emailComposeTask.To = "recipient@example.com"
   emailComposeTask.Cc = "cc@example.com"
   emailComposeTask.Bcc = "bcc@example.com"
   
   emailComposeTask.Show()
   

Note

If an email account is not set up on the phone, the application prompts the user to set up an account.

See Also

Reference

EmailComposeTask

Other Resources

How to use the SMS compose task for Windows Phone 8

How to use the email address chooser task for Windows Phone 8

How to use the save email address task for Windows Phone 8