Collapse the table of content
Expand the table of content

Windows.ApplicationModel.Contacts namespace

Enables apps to select and acquire info about contacts.

Important  This namespace includes some members that are new for Windows 8.1 and other members that may be unavailable after Windows 8.1. These two types of members don't work together, and calling both from the same app will cause the app to fail. We recommend that you call only members that aren't marked with the unavailability warning.


The Windows.ApplicationModel.Contacts namespace has these types of members:


AggregateContactManager Provides functionality for linking individual (raw) contacts across services together into a single aggregate contact.
Contact Represents a contact.
ContactAddress Represents the address of a contact.
ContactAnnotation Provides a way to tag existing user contacts with additional information, specifying that your app can perform some SupportedOperations for this particular contact.
ContactAnnotationList Represents a list of ContactAnnotation objects.
ContactAnnotationStore Represents a data store that contains contact annotations.
ContactBatch Represents a group of Contact objects and server search status.
ContactCardDelayedDataLoader Represents a delayed data loader for a contact card.
ContactCardOptions Represents data about how to display a mini contact card.
ContactChange Represents a change to a Contact.
ContactChangedDeferral The deferral object to use while asynchronously processing ContactChanged events.
ContactChangedEventArgs Provides data for the ContactChanged event.
ContactChangeReader Provides a way to monitor and react to changes to contacts.
ContactChangeTracker Provides functionality for monitoring changes to Contact objects in the ContactStore.
ContactConnectedServiceAccount Represents a connected service account for a contact.
ContactDate Represents an important date for a contact.
ContactEmail Represents an email address of a contact.
ContactField Describes a piece of contact data.
ContactFieldFactory Creates fields that contain information about a contact.
ContactInformation Contains the information about a contact.
ContactInstantMessageField Defines a field that is an instant messaging (IM) address.
ContactJobInfo Represents job info for a contact.
ContactLaunchActionVerbs Provides data when an app is launched to perform an action to a contact.
ContactList Represents a list of Contact objects.
ContactListSyncConstraints Specifies limits on how much contact list data can be synchronized.
ContactListSyncManager Provides functionality for syncing contact information with the server.
ContactLocationField Contains information about a user's location and address.
ContactManager Represents a service that source apps can call to access contact data.
ContactManagerForUser Represents a service that source apps can call to access contact data for a specific user.
ContactMatchReason Provides details about why search results matched the query parameters.
ContactPhone Represents info about the phone for a contact.
ContactPicker Controls how the Contact Picker user interface opens and what information it shows.
ContactQueryOptions Used to specify the query options when searching for contacts.
ContactQueryTextSearch Specifies parameters to use in a text search of Contact objects.
ContactReader Used to read Contact objects in batches from the ContactStore which may be local or remotely located.
ContactSignificantOther Represents the info about a significant other for a contact.
ContactStore Represents a database that contains contacts.
ContactStoreNotificationTriggerDetails Reserved for future use.
ContactWebsite Represents the info about a Web site for a contact.
FullContactCardOptions Specifies the options for displaying the full contact card.
KnownContactField KnownContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactConnectedServiceAccount, or ContactEmail.A static class that contains the names of contact fields for storing commonly requested information like email address and phone numbers.



The Windows.ApplicationModel.Contacts namespace has these enumerations.

ContactAddressKind Specifies the kinds of contact addresses.
ContactAnnotationOperations Specifies the types of operations you can perform with a Contact.
ContactAnnotationStoreAccessType Specifies if the app can read and write all annotations or only those belonging to the app itself.
ContactBatchStatus Specifies if the last batch access operation was successful or if there was a server error.
ContactCardHeaderKind Specifies the type of header information to show on a contact card.
ContactCardTabKind Specifies which tab to display on a mini contact card.
ContactChangeType Specifies the type of change that occurred for a ContactChanged event.
ContactDateKind Specifies the kinds of important dates for a contact.
ContactEmailKind Specifies the kinds of email addresses for a contact.
ContactFieldCategory ContactFieldCategory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactPhoneKind, ContactEmailKind, and ContactAddressKind.Defines the categories that contact data can belong to.
ContactFieldType Defines the type of contact data.
ContactListOtherAppReadAccess Specifies the level of contact read access granted to other apps.
ContactListOtherAppWriteAccess Specifies the level of contact write access granted to other apps.
ContactListSyncStatus Defines the ContactList sync status.
ContactMatchReasonKind Defines the reasons that a Contact matched a search.
ContactNameOrder Specifies the name order for a contact.
ContactPhoneKind Specifies the kinds of phones for a contact.
ContactQueryDesiredFields Defines which fields must exist on a contact in order to match a search operation.
ContactQuerySearchFields Defines which contact fields to search for a text match.
ContactQuerySearchScope Defines whether to search the local ContactStore or a server.
ContactRelationship Defines a value that indicates the nature of a contact relationship, such as spouse, partner, sibling, parent and so on.
ContactSelectionMode Specifies whether you want to request an entire contact, or only specific fields.
ContactStoreAccessType Defines the type of access the app has to the ContactStore.



The Windows.ApplicationModel.Contacts namespace defines these interfaces.

IContactField IContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate.Specifies an object that describes a piece of contact data.
IContactFieldFactory IContactFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactPhone or ContactEmail. Creates fields that contain information about a contact. Available only to apps that support the Contacts contract.
IContactInstantMessageFieldFactory IContactInstantMessageFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount.Creates fields with information about a contact's instant messaging accounts.
IContactLocationFieldFactory IContactLocationFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress. Creates fields for a contact's location.



For info about how to manage contacts, see Managing contact cards (XAML) and Managing contact cards (HTML).

See also

Contact manager API sample
Contact Picker app sample
Handling Contact Actions sample
Contact Card integration sample (Windows 10)
Contact cards sample (Windows 10)



© 2016 Microsoft