Windows.ApplicationModel.Contacts namespace

Applies to Windows and Windows Phone

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

The Windows.ApplicationModel.Contacts namespace has these classes.

ClassDescription
Contact Represents a contact.
ContactAddress Represents the address of a contact.
ContactCardDelayedDataLoader Represents a delayed data loader for a contact card.
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 ContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate. Describes a piece of contact data.
ContactFieldFactory ContactFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactWebsite, ContactJobInfo, or ContactDate. Creates fields that contain information about a contact.
ContactInformation ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact. Contains the information about a contact.
ContactInstantMessageField ContactInstantMessageField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. 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.
ContactLocationField ContactLocationField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress. Contains information about a user's location and address.
ContactManager Represents a service that source apps can call to access contact data.
ContactPhone Represents info about the phone for a contact.
ContactPicker Controls how the Contact Picker user interface opens and what information it shows.
ContactSignificantOther Represents the info about a significant other for a contact.
ContactStore Represents the store of contacts on the device. Use this class to find and retrieve contacts.
ContactWebsite Represents the info about a Web site for a contact.
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.
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.
ContactPhoneKind Specifies the kinds of phones for a contact.
ContactSelectionMode Specifies whether you want to request an entire contact, or only specific fields.

 

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:
© 2014 Microsoft