How to use the save phone number task for Windows Phone 8

Article
05/20/2016

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

Use the save phone number task to enable a user to save a phone number 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 phone number task

Add the following statement to your code.

using Microsoft.Phone.Tasks;

Imports Microsoft.Phone.Tasks

Declare the task object. It must have page scope, so declare it in your page before the constructor.
```
SavePhoneNumberTask savePhoneNumberTask;
```
```
Dim savePhoneNumberTask As SavePhoneNumberTask
```

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.

savePhoneNumberTask = new SavePhoneNumberTask();
savePhoneNumberTask.Completed += new EventHandler<TaskEventArgs>(savePhoneNumberTask_Completed);

savePhoneNumberTask = new SavePhoneNumberTask()
AddHandler savePhoneNumberTask.Completed, AddressOf savePhoneNumberTask_Completed

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 phone number, but it is not required. The user can add or edit the phone number before saving.
```
savePhoneNumberTask.PhoneNumber = "2065550123";

savePhoneNumberTask.Show();
```
```
savePhoneNumberTask.PhoneNumber = "2065550123"

savePhoneNumberTask.Show()
```

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 phone number was saved successfully.

void savePhoneNumberTask_Completed(object sender, TaskEventArgs e)
{
    switch (e.TaskResult)
    {
        //Logic for when the number was saved successfully
        case TaskResult.OK:
            MessageBox.Show("Phone number saved.");
            break;

        //Logic for when the task was cancelled by the user
        case TaskResult.Cancel:
            MessageBox.Show("Save cancelled.");
            break;

        //Logic for when the number could not be saved
        case TaskResult.None:
            MessageBox.Show("Phone number could not be saved.");
            break;
    }
}

Private Sub savePhoneNumberTask_Completed(sender As Object, e As TaskEventArgs)

    Select Case e.TaskResult

        'Logic for when the number was saved successfully
        Case TaskResult.OK

            MessageBox.Show("Phone number saved.")

        'Logic for when the task was cancelled by the user
        Case TaskResult.Cancel

            MessageBox.Show("Save cancelled.")

        'Logic for when the number could not be saved
        Case TaskResult.None

            MessageBox.Show("Phone number could not be saved.")
    End Select
End Sub

How to use the save phone number task for Windows Phone 8

To use the phone number task

See Also

Reference

Other Resources

Additional resources