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.

Classes

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

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

Microsoft Internal Use Only.

ContactInformation

Contains the information about a contact.

Note

ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use 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.

ContactListLimitedWriteOperations

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

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.

Note

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

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.

ContactPanel

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

ContactPanelClosingEventArgs

Provides event information for the Closing event.

ContactPanelLaunchFullAppRequestedEventArgs

Provides event information for the LaunchFullAppRequested event.

ContactPhone

Represents information 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

A static class that contains the names of contact fields for storing commonly requested information like email address and phone numbers.

Note

KnownContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactConnectedServiceAccount, or ContactEmail.

PinnedContactIdsQueryResult

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

PinnedContactManager

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

In a desktop app, before using an instance of this class in a way that displays UI, you'll need to associate the object with its owner's window handle. For more info, and code examples, see Display WinRT UI objects that depend on CoreWindow.

Interfaces

IContactField

Specifies an object that describes a piece of contact data.

Note

IContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate.

IContactFieldFactory

Creates fields that contain information about a contact. Available only to apps that support the Contacts contract.

Note

IContactFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactPhone or ContactEmail.

IContactInstantMessageFieldFactory

Creates fields with information about a contact's instant messaging accounts.

Note

IContactInstantMessageFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount.

IContactLocationFieldFactory

Creates fields for a contact's location.

Note

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

Enums

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

Defines the categories that contact data can belong to.

Note

ContactFieldCategory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactPhoneKind, ContactEmailKind, and ContactAddressKind.

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.

PinnedContactSurface

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

Remarks

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

See also