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 | |
|---|---|---|
.gif "Public method") |
Contacts | Initializes a new instance of the Contacts class. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Accounts | Gets the accounts from which contacts are available. |
.gif "Protected property") |
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.) |
.gif "Protected method") |
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 | |
|---|---|---|
.gif "Public event") |
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