Contact Class

Article
11/23/2015

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

Contains all available information about an individual contact.

Inheritance Hierarchy

System..::.Object
Microsoft.Phone.UserData..::.Contact

Namespace: Microsoft.Phone.UserData
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)

Syntax

Public NotInheritable Class Contact

public sealed class Contact

The Contact type exposes the following members.

Properties

	Name	Description
	Accounts	Gets the data sources associated with this contact.
	Addresses	Gets the addresses associated with this contact.
	Birthdays	Gets the birthdays associated with this contact.
	Children	Gets the children associated with this contact.
	Companies	Gets the companies associated with this contact.
	CompleteName	Gets the complete name associated with this contact.
	DisplayName	Gets the display name of the contact.
	EmailAddresses	Gets the email addresses associated with this contact.
	IsPinnedToStart	Gets a value that indicates whether the contact is pinned to the Start screen.
	Notes	Gets the notes associated with this contact.
	PhoneNumbers	Gets the phone numbers associated with this contact.
	SignificantOthers	Gets the significant others associated with this contact.
	Websites	Gets the websites associated with this contact.

Top

Methods

	Name	Description
	Equals	Determines whether the specified contact is equal to the current contact. (Overrides Object..::.Equals(Object).)
	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 the contact type. (Overrides Object..::.GetHashCode()()().)
	GetPicture	Gets a picture of the contact.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current contact. (Overrides Object..::.ToString()()().)

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.

All individual Contact objects come from the SearchAsync method of the Contacts object.

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

Share via