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

How to use the save email address 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 save email address task to enable a user to save an email address from your application. This task launches the Contacts application.

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

To use the save email address task

  1. Add the following statement to your code.

    Imports Microsoft.Phone.Tasks
  2. Declare the task object. It must have page scope, so declare it in your page before the constructor.

    Dim saveEmailAddressTask As SaveEmailAddressTask
  3. Add the following code to your page constructor. This code initializes the task object, and identifies the method to run after the user completes the task.

    saveEmailAddressTask = new SaveEmailAddressTask()
    AddHandler saveEmailAddressTask.Completed, AddressOf saveEmailAddressTask_Completed
  4. 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.

    You can pre-populate the email address, but it is not required. The user can add or edit the email address before saving.

    saveEmailAddressTask.Email = ""
  5. Add the code for the completed event handler to your page. This code runs after the user completes the task. You can check to see whether the email was saved successfully.

    Private Sub saveEmailAddressTask_Completed(sender As Object, e As TaskEventArgs)
        Select Case e.TaskResult
            'Logic for when the email was saved successfully
            Case TaskResult.OK
                MessageBox.Show("Email saved.")
            'Logic for when the task was cancelled by the user
            Case TaskResult.Cancel
                MessageBox.Show("Save cancelled.")
            'Logic for when the email could not be saved
            Case TaskResult.None
                MessageBox.Show("Email could not be saved.")
        End Select
    End Sub

© 2017 Microsoft