ContactInformation 类

定义

命名空间:

Windows.ApplicationModel.Contacts

包含有关联系人的信息。

注意

Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。

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

继承

Object Platform::Object IInspectable ContactInformation

属性

ContractVersionAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能	contactsSystem

注解

注意

由于在Windows 8.1及更高版本的应用中不使用 PickSingleContactAsync 和 PickMultipleContactsAsync，因此不会在Windows 8.1及更高版本的应用中实例化 ContactInformation 对象。此表显示了现有的 Windows 8 ContactInformation 属性及其等效Windows 8.1联系人属性。

Windows 8 ContactInformation 属性	Windows 8.1 Contact 属性
Contact.Name	Contact.Name
Contact.Thumbnail	Contact.Thumbnail
Contact.Fields	Contact.电子邮件
Contact.Fields，其中 ContactField.Value = Address and ContactField.Category = ContactFieldCategory.Home 或 ContactFieldCategory.Other	Contact.Addresses
Contact.Fields	Contact.Phone
ContactField.Value	ContactEmail.Address
ContactField.Category (Home，Work，Other)	ContactEmail.Kind (Personal，Work，Other)
ContactField.Value	ContactPhone.Number
ContactField.Category (家庭、工作、移动、其他)	ContactPhone.Kind (家庭，工作，移动，其他)
Contact.Fields，其中 ContactField.Value = CompanyAddress 和 ContactField.Category = ContactFieldCategory.Work	ContactJobInfo.CompanyAddress

通常，访问 ContactInformation 对象是异步方法和/或函数调用的结果。 例如， PickSingleContactAsync 和 PickMultipleContactsAsync 这两个静态方法都返回代表所选联系人的 ContactInformation 对象。

当应用从联系人提供程序接收联系人信息时，每个联系人的数据将在 ContactInformation 对象中返回。

属性

CustomFields	随联系人一起存储的自定义字段的只读列表。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。
Emails	随联系人一起存储的电子邮件地址的只读列表。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。
InstantMessages	随联系人一起存储的即时消息帐户的只读列表。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。
Locations	随联系人一起存储的位置的只读列表。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。
Name	联系人的姓名。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。
PhoneNumbers	随联系人一起存储的电话号码的只读列表。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。

方法

GetThumbnailAsync()	获取联系人的缩略图。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。
QueryCustomFields(String)	使你能够获取随联系人一起存储的自定义字段的值。 注意 在Windows 8.1后，ContactInformation 可能会更改或不可用。 请改用 “联系人”。