Contact 类

定义

命名空间:

Windows.ApplicationModel.Contacts

表示联系人。

public ref class Contact sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Contact final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Contact

function Contact()

Public NotInheritable Class Contact

继承

Object Platform::Object IInspectable Contact

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

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

注解

无论你如何在应用中存储联系人信息，都必须能够将该信息放入 Contact 对象中。 这样，允许用户选择联系人的其他应用可以使用你的应用并处理它提供的联系人信息。

有关如何管理联系人的信息，请参阅 联系人和日历。

构造函数

Contact()

创建 Contact 类的新实例。

属性

Addresses	获取联系人的联系人地址。
AggregateId	如果这是属于聚合联系人的原始联系人，则此属性标识父聚合。
ConnectedServiceAccounts	获取联系人的连接服务帐户。
ContactListId	获取一个字符串，该字符串标识此联系人所属的 ContactList 。
DataSuppliers	获取联系人的数据提供程序。 每个数据提供程序的最大字符串长度为 50 个字符。
DisplayName	获取联系人的显示名称。
DisplayNameOverride	获取或设置用户手动输入的显示名称。
DisplayPictureUserUpdateTime	获取或设置用户上次更新其显示图片的时间。
Emails	获取联系人的电子邮件地址。
Fields	设置包含有关联系人信息的字段。 注意 FieldsWindows 8.1后，版本可能已更改或不可用。 请改用 电话、 电子邮件、 地址或 ConnectedServiceAccounts。
FirstName	获取或设置联系人的名字。 名字的最大字符串长度为 64 个字符。
FullName	获取 联系人的全名。
HonorificNamePrefix	获取或设置联系人姓名的荣誉前缀。 荣誉前缀的最大字符串长度为 32 个字符。
HonorificNameSuffix	获取或设置联系人姓名的荣誉后缀。 荣誉后缀的最大字符串长度为 32 个字符。
Id	获取或设置联系人的标识符。 标识符的最大字符串长度为 256 个字符。
ImportantDates	获取联系人的重要日期。
IsAggregate	获取一个值，该值指示这是否是聚合 联系人。
IsDisplayPictureManuallySet	获取一个布尔值，该值指示用户是否手动设置 联系人的图片。
IsMe	获取一个布尔值，该值指示此 联系人 是否表示登录到设备的用户。
JobInfo	获取联系人的作业信息项。
LargeDisplayPicture	获取 联系人显示图片的大版本。
LastName	获取或设置联系人的姓氏。 姓氏的最大字符串长度为 64 个字符。
MiddleName	获取或设置联系人的中间名。 中间名的最大字符串长度为 64 个字符。
Name	设置并获取联系人的姓名。 注意 Windows 8.1后，名称可能会更改或不可用。 请改用 FirstName、 MiddleName 和 LastName。
Nickname	获取或设置 联系人的昵称。
Notes	获取或设置联系人的备注。 备注的最大字符串长度为 4096 个字符。
Phones	获取有关联系人电话的信息。
ProviderProperties	获取联系人的属性集对象。
RemoteId	获取或设置服务提供商可用于访问其远程系统中的 联系人 的 ID。
RingToneToken	获取或设置 联系人的铃声文件的路径。
SignificantOthers	获取联系人的重要其他联系人。
SmallDisplayPicture	获取 联系人的显示图片的小型版本。
SortName	获取用于对联系人进行排序的名称。
SourceDisplayPicture	获取或设置 联系人 的原始大小的显示图片。
TextToneToken	获取或设置从 联系人收到短信/MMS 消息时要播放的音频文件的路径。
Thumbnail	获取或设置表示此联系人的缩略图。
Websites	获取联系人的网站。
YomiDisplayName	获取联系人的 Yomi (拼音日语等效) 显示名称。
YomiFamilyName	获取或设置联系人的 Yomi (拼音日语等效) 姓氏。 Yomi 系列名称的最大字符串长度为 120 个字符。
YomiGivenName	获取或设置联系人的 Yomi (拼音日语等效) 给定名称。 Yomi 给定名称的最大字符串长度为 120 个字符。

另请参阅

• 联系人管理器 API 示例
• 联系人选取器应用示例
• 处理联系人操作示例
• 联系人卡片示例 (Windows 10)