Contacts Class

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

Provides methods and events for interacting with a user’s contact data.

Inheritance Hierarchy


Namespace:  Microsoft.Phone.UserData
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.


Public NotInheritable Class Contacts _
    Inherits PhoneDataSharingContext
public sealed class Contacts : PhoneDataSharingContext
<Contacts .../>

The Contacts type exposes the following members.


  Name Description
Contacts Initializes a new instance of the Contacts class.



  Name Description
Accounts Gets the accounts from which contacts are available.
BaseUri Gets the string used to indicate the data context. (Inherited from PhoneDataSharingContext.)



  Name Description
Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
ExecuteRequest<(Of <(T>)>) Performs a search for objects in a data context. (Inherited from PhoneDataSharingContext.)
Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
GetType Gets the Type of the current instance. (Inherited from Object.)
InitializeInteropContext Initializes the interop context so that native code can access the Contact and Appointment objects. (Inherited from PhoneDataSharingContext.)
MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
SearchAsync Asynchronously searches for contacts in the user’s contact data.
ToString Returns a string that represents the current object. (Inherited from Object.)



  Name Description
SearchCompleted Occurs when a search for contacts completes.



Windows Phone provides an aggregated view of the user’s contact data across the user's different accounts. Information can come from sources such as data entered in the phone itself, social networking sites, and other data service providers. Not all data from all service providers is exposed publicly through this API. The StorageKind enumeration lists the possible sources of data.


If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.


Windows Phone 8, Windows Phone OS 7.1


Windows Phone 8

For more info, see App capabilities and hardware requirements for Windows Phone 8.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1


Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also


Microsoft.Phone.UserData Namespace

Other Resources

Contacts and Calendar for Windows Phone 8

How to access contact data for Windows Phone 8