Windows.ApplicationModel.Contacts Windows.ApplicationModel.Contacts Windows.ApplicationModel.Contacts Windows.ApplicationModel.Contacts Windows.ApplicationModel.Contacts Namespace

Enables apps to select and acquire info about contacts.


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.


AggregateContactManager AggregateContactManager AggregateContactManager AggregateContactManager AggregateContactManager

Provides functionality for linking individual (raw) contacts across services together into a single aggregate contact.

Contact Contact Contact Contact Contact

Represents a contact.

ContactAddress ContactAddress ContactAddress ContactAddress ContactAddress

Represents the address of a contact.

ContactAnnotation ContactAnnotation ContactAnnotation ContactAnnotation 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 ContactAnnotationList ContactAnnotationList ContactAnnotationList ContactAnnotationList

Represents a list of ContactAnnotation objects.

ContactAnnotationStore ContactAnnotationStore ContactAnnotationStore ContactAnnotationStore ContactAnnotationStore

Represents a data store that contains contact annotations.

ContactBatch ContactBatch ContactBatch ContactBatch ContactBatch

Represents a group of Contact objects and server search status.

ContactCardDelayedDataLoader ContactCardDelayedDataLoader ContactCardDelayedDataLoader ContactCardDelayedDataLoader ContactCardDelayedDataLoader

Represents a delayed data loader for a contact card.

ContactCardOptions ContactCardOptions ContactCardOptions ContactCardOptions ContactCardOptions

Represents data about how to display a mini contact card.

ContactChange ContactChange ContactChange ContactChange ContactChange

Represents a change to a Contact.

ContactChangedDeferral ContactChangedDeferral ContactChangedDeferral ContactChangedDeferral ContactChangedDeferral

The deferral object to use while asynchronously processing ContactChanged events.

ContactChangedEventArgs ContactChangedEventArgs ContactChangedEventArgs ContactChangedEventArgs ContactChangedEventArgs

Provides data for the ContactChanged event.

ContactChangeReader ContactChangeReader ContactChangeReader ContactChangeReader ContactChangeReader

Provides a way to monitor and react to changes to contacts.

ContactChangeTracker ContactChangeTracker ContactChangeTracker ContactChangeTracker ContactChangeTracker

Provides functionality for monitoring changes to Contact objects in the ContactStore.

ContactConnectedServiceAccount ContactConnectedServiceAccount ContactConnectedServiceAccount ContactConnectedServiceAccount ContactConnectedServiceAccount

Represents a connected service account for a contact.

ContactDate ContactDate ContactDate ContactDate ContactDate

Represents an important date for a contact.

ContactEmail ContactEmail ContactEmail ContactEmail ContactEmail

Represents an email address of a contact.

ContactField ContactField ContactField ContactField ContactField

Describes a piece of contact data.

ContactFieldFactory ContactFieldFactory ContactFieldFactory ContactFieldFactory ContactFieldFactory

Creates fields that contain information about a contact. You can then add these fields to a Contact object to create the contact. This class is available only to apps that support the Contact contract.

ContactGroup ContactGroup ContactGroup ContactGroup ContactGroup

This API supports the product infrastructure and is not intended to be used directly from your code.

Microsoft Internal Use Only.

ContactInformation ContactInformation ContactInformation ContactInformation ContactInformation

Contains the information about a contact.

ContactInstantMessageField ContactInstantMessageField ContactInstantMessageField ContactInstantMessageField ContactInstantMessageField

Defines a field that is an instant messaging (IM) address.

ContactJobInfo ContactJobInfo ContactJobInfo ContactJobInfo ContactJobInfo

Represents job info for a contact.

ContactLaunchActionVerbs ContactLaunchActionVerbs ContactLaunchActionVerbs ContactLaunchActionVerbs ContactLaunchActionVerbs

Provides data when an app is launched to perform an action to a contact.

ContactList ContactList ContactList ContactList ContactList

Represents a list of Contact objects.

ContactListLimitedWriteOperations ContactListLimitedWriteOperations ContactListLimitedWriteOperations ContactListLimitedWriteOperations ContactListLimitedWriteOperations

Provides operations that an app can perform on a contact list that it has not created.

ContactListSyncConstraints ContactListSyncConstraints ContactListSyncConstraints ContactListSyncConstraints ContactListSyncConstraints

Specifies limits on how much contact list data can be synchronized.

ContactListSyncManager ContactListSyncManager ContactListSyncManager ContactListSyncManager ContactListSyncManager

Provides functionality for syncing contact information with the server.

ContactLocationField ContactLocationField ContactLocationField ContactLocationField ContactLocationField

Contains information about a user's location and address.

ContactManager ContactManager ContactManager ContactManager ContactManager

Represents a service that source apps can call to access contact data.

ContactManagerForUser ContactManagerForUser ContactManagerForUser ContactManagerForUser ContactManagerForUser

Represents a service that source apps can call to access contact data for a specific user.

ContactMatchReason ContactMatchReason ContactMatchReason ContactMatchReason ContactMatchReason

Provides details about why search results matched the query parameters.

ContactPanel ContactPanel ContactPanel ContactPanel ContactPanel

Represents a Contact Panel that appears when users click a contact that is pinned to the taskbar.

ContactPanelClosingEventArgs ContactPanelClosingEventArgs ContactPanelClosingEventArgs ContactPanelClosingEventArgs ContactPanelClosingEventArgs

Provides event information for the Closing event.

ContactPanelLaunchFullAppRequestedEventArgs ContactPanelLaunchFullAppRequestedEventArgs ContactPanelLaunchFullAppRequestedEventArgs ContactPanelLaunchFullAppRequestedEventArgs ContactPanelLaunchFullAppRequestedEventArgs

Provides event information for the LaunchFullAppRequested event.

ContactPhone ContactPhone ContactPhone ContactPhone ContactPhone

Represents information about the phone for a contact.

ContactPicker ContactPicker ContactPicker ContactPicker ContactPicker

Controls how the Contact Picker user interface opens and what information it shows.

ContactQueryOptions ContactQueryOptions ContactQueryOptions ContactQueryOptions ContactQueryOptions

Used to specify the query options when searching for contacts.

ContactQueryTextSearch ContactQueryTextSearch ContactQueryTextSearch ContactQueryTextSearch ContactQueryTextSearch

Specifies parameters to use in a text search of Contact objects.

ContactReader ContactReader ContactReader ContactReader ContactReader

Used to read Contact objects in batches from the ContactStore which may be local or remotely located.

ContactSignificantOther ContactSignificantOther ContactSignificantOther ContactSignificantOther ContactSignificantOther

Represents the info about a significant other for a contact.

ContactStore ContactStore ContactStore ContactStore ContactStore

Represents a database that contains contacts.

ContactStoreNotificationTriggerDetails ContactStoreNotificationTriggerDetails ContactStoreNotificationTriggerDetails ContactStoreNotificationTriggerDetails ContactStoreNotificationTriggerDetails

Reserved for future use.

ContactWebsite ContactWebsite ContactWebsite ContactWebsite ContactWebsite

Represents the info about a Web site for a contact.

FullContactCardOptions FullContactCardOptions FullContactCardOptions FullContactCardOptions FullContactCardOptions

Specifies the options for displaying the full contact card.

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

PinnedContactIdsQueryResult PinnedContactIdsQueryResult PinnedContactIdsQueryResult PinnedContactIdsQueryResult PinnedContactIdsQueryResult

Provides access to the results of a query that lists the IDs all contacts pinned to the taskbar or Start menu.

PinnedContactManager PinnedContactManager PinnedContactManager PinnedContactManager PinnedContactManager

Represents a service that source apps can call to pin and unpin contacts to and from the taskbar or Start menu.


IContactField IContactField IContactField IContactField 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 IContactFieldFactory IContactFieldFactory 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 IContactInstantMessageFieldFactory IContactInstantMessageFieldFactory 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 IContactLocationFieldFactory IContactLocationFieldFactory IContactLocationFieldFactory


IContactLocationFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress.

Creates fields for a contact's location.


ContactAddressKind ContactAddressKind ContactAddressKind ContactAddressKind ContactAddressKind

Specifies the kinds of contact addresses.

ContactAnnotationOperations ContactAnnotationOperations ContactAnnotationOperations ContactAnnotationOperations ContactAnnotationOperations

Specifies the types of operations you can perform with a Contact.

ContactAnnotationStoreAccessType ContactAnnotationStoreAccessType ContactAnnotationStoreAccessType ContactAnnotationStoreAccessType ContactAnnotationStoreAccessType

Specifies if the app can read and write all annotations or only those belonging to the app itself.

ContactBatchStatus ContactBatchStatus ContactBatchStatus ContactBatchStatus ContactBatchStatus

Specifies if the last batch access operation was successful or if there was a server error.

ContactCardHeaderKind ContactCardHeaderKind ContactCardHeaderKind ContactCardHeaderKind ContactCardHeaderKind

Specifies the type of header information to show on a contact card.

ContactCardTabKind ContactCardTabKind ContactCardTabKind ContactCardTabKind ContactCardTabKind

Specifies which tab to display on a mini contact card.

ContactChangeType ContactChangeType ContactChangeType ContactChangeType ContactChangeType

Specifies the type of change that occurred for a ContactChanged event.

ContactDateKind ContactDateKind ContactDateKind ContactDateKind ContactDateKind

Specifies the kinds of important dates for a contact.

ContactEmailKind ContactEmailKind ContactEmailKind ContactEmailKind ContactEmailKind

Specifies the kinds of email addresses for a contact.

ContactFieldCategory ContactFieldCategory ContactFieldCategory ContactFieldCategory 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 ContactFieldType ContactFieldType ContactFieldType ContactFieldType

Defines the type of contact data.

ContactListOtherAppReadAccess ContactListOtherAppReadAccess ContactListOtherAppReadAccess ContactListOtherAppReadAccess ContactListOtherAppReadAccess

Specifies the level of contact read access granted to other apps.

ContactListOtherAppWriteAccess ContactListOtherAppWriteAccess ContactListOtherAppWriteAccess ContactListOtherAppWriteAccess ContactListOtherAppWriteAccess

Specifies the level of contact write access granted to other apps.

ContactListSyncStatus ContactListSyncStatus ContactListSyncStatus ContactListSyncStatus ContactListSyncStatus

Defines the ContactList sync status.

ContactMatchReasonKind ContactMatchReasonKind ContactMatchReasonKind ContactMatchReasonKind ContactMatchReasonKind

Defines the reasons that a Contact matched a search.

ContactNameOrder ContactNameOrder ContactNameOrder ContactNameOrder ContactNameOrder

Specifies the name order for a contact.

ContactPhoneKind ContactPhoneKind ContactPhoneKind ContactPhoneKind ContactPhoneKind

Specifies the kinds of phones for a contact.

ContactQueryDesiredFields ContactQueryDesiredFields ContactQueryDesiredFields ContactQueryDesiredFields ContactQueryDesiredFields

Defines which fields must exist on a contact in order to match a search operation.

ContactQuerySearchFields ContactQuerySearchFields ContactQuerySearchFields ContactQuerySearchFields ContactQuerySearchFields

Defines which contact fields to search for a text match.

ContactQuerySearchScope ContactQuerySearchScope ContactQuerySearchScope ContactQuerySearchScope ContactQuerySearchScope

Defines whether to search the local ContactStore or a server.

ContactRelationship ContactRelationship ContactRelationship ContactRelationship ContactRelationship

Defines a value that indicates the nature of a contact relationship, such as spouse, partner, sibling, parent and so on.

ContactSelectionMode ContactSelectionMode ContactSelectionMode ContactSelectionMode ContactSelectionMode

Specifies whether you want to request an entire contact, or only specific fields.

ContactStoreAccessType ContactStoreAccessType ContactStoreAccessType ContactStoreAccessType ContactStoreAccessType

Defines the type of access the app has to the ContactStore.

PinnedContactSurface PinnedContactSurface PinnedContactSurface PinnedContactSurface PinnedContactSurface

Specifies the location in the Windows user interface to which a contact can be pinned.


For info about how to manage contacts, see Managing contact cards and Managing contact cards.

See also