Windows Dev Center

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.

Members

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

Classes

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

 

Enumerations

The Windows.ApplicationModel.Contacts namespace has these enumerations.

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

 

Interfaces

The Windows.ApplicationModel.Contacts namespace defines these interfaces.

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

 

Remarks

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

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

Metadata

Windows.winmd

See also

Contact manager API sample
Contact Picker app sample
Handling Contact Actions sample
Windows.ApplicationModel.Contacts.Provider

 

 

Show:
© 2015 Microsoft