ContactInformation 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
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 ContactInformationPublic NotInheritable Class ContactInformation- 继承
- 属性
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 可能会更改或不可用。 请改用 “联系人”。 |