ContactInformation Class

Reference

Definition

Namespace:: Windows.ApplicationModel.Contacts

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Contains the information about a contact.

Note

ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.

public ref class ContactInformation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ContactInformation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ContactInformation

Public NotInheritable Class ContactInformation

Inheritance: Object Platform::Object IInspectable ContactInformation

Attributes: ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)
App capabilities	contactsSystem

Remarks

Note

Because you don't use PickSingleContactAsync and PickMultipleContactsAsync in your Windows 8.1 and later apps, you don't instantiate ContactInformation objects in your Windows 8.1 and later apps.This table shows existing Windows 8 ContactInformation properties and their equivalent Windows 8.1 Contact properties.

Windows 8 ContactInformation property	Windows 8.1 Contact property
Contact.Name	Contact.Name
Contact.Thumbnail	Contact.Thumbnail
Contact.Fields	Contact.Emails
Contact.Fields where ContactField.Value = Address and ContactField.Category = ContactFieldCategory.Home or ContactFieldCategory.Other	Contact.Addresses
Contact.Fields	Contact.Phones
ContactField.Value	ContactEmail.Address
ContactField.Category(Home,Work,Other)	ContactEmail.Kind(Personal,Work,Other)
ContactField.Value	ContactPhone.Number
ContactField.Category(Home, Work, Mobile, Other)	ContactPhone.Kind(Home,Work,Mobile,Other)
Contact.Fields where ContactField.Value = CompanyAddress and ContactField.Category = ContactFieldCategory.Work	ContactJobInfo.CompanyAddress

Typically, you access ContactInformation objects as the result of asynchronous method and/or function calls. For example, both of the static methods PickSingleContactAsync and PickMultipleContactsAsync return ContactInformation objects that represent the selected contact.

When your app receives contact information from a contact provider, the data for each contact is returned in a ContactInformation object.

Properties

CustomFields	A read-only list of the custom fields stored with the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.
Emails	A read-only list of email addresses stored with the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.
InstantMessages	A read-only list of instant messaging accounts stored with the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.
Locations	A read-only list of locations stored with the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.
Name	The name of the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.
PhoneNumbers	A read-only list of phone numbers stored with the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.

Methods

GetThumbnailAsync()	Gets the thumbnail image for the contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.
QueryCustomFields(String)	Enables you to get the value for a custom field that is stored with a contact. Note ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact.

Applies to

Jaa