Share via


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

System..::.Object
  Microsoft.Phone.UserData..::.PhoneDataSharingContext
    Microsoft.Phone.UserData..::.Contacts

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

Syntax

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

The Contacts type exposes the following members.

Constructors

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

Top

Properties

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

Top

Methods

  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.)

Top

Events

  Name Description
SearchCompleted Occurs when a search for contacts completes.

Top

Remarks

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.

Capabilities

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.

ID_CAP_CONTACTS

Windows Phone 8, Windows Phone OS 7.1

ID_CAP_APPOINTMENTS

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

Platforms

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

Reference

Microsoft.Phone.UserData Namespace

Other Resources

Contacts and Calendar for Windows Phone 8

How to access contact data for Windows Phone 8