Windows.ApplicationModel.Contacts 命名空间

使应用能够选择和获取有关联系人的信息。

重要

此命名空间包括Windows 8.1的一些新成员，以及Windows 8.1后可能不可用的其他成员。 这两种类型的成员无法协同工作，并且从同一应用调用这两种成员将导致应用失败。 建议仅调用未标有不可用警告的成员。

类

名称	说明
AggregateContactManager	提供将各个服务 (原始) 联系人链接到单个聚合联系人的功能。
Contact	表示联系人。
ContactAddress	表示联系人的地址。
ContactAnnotation	提供一种使用其他信息标记现有用户联系人的方法，指定你的应用可以为此特定联系人执行一些 SupportedOperation。
ContactAnnotationList	表示 ContactAnnotation 对象的列表。
ContactAnnotationStore	表示包含联系人注释的数据存储。
ContactBatch	表示一组 Contact 对象和服务器搜索状态。
ContactCardDelayedDataLoader	表示联系人卡的延迟数据加载程序。
ContactCardOptions	表示有关如何显示微型触点卡的数据。
ContactChange	表示对 联系人的更改。
ContactChangedDeferral	异步处理 ContactChanged 事件时要使用的延迟对象。
ContactChangedEventArgs	提供 ContactChanged 事件的数据。
ContactChangeReader	提供一种监视和响应联系人更改的方法。
ContactChangeTracker	提供监视 ContactStore 中 Contact 对象更改的功能。
ContactConnectedServiceAccount	表示联系人的连接服务帐户。
ContactDate	表示联系人的重要日期。
ContactEmail	表示联系人的电子邮件地址。
ContactField	描述一段联系人数据。
ContactFieldFactory	创建包含有关联系人信息的字段。 然后，可以将这些字段添加到 Contact 对象以创建联系人。 此类仅适用于支持“联系人”合约的应用。
ContactGroup	此 API 支持产品基础结构，不能在代码中直接使用。 仅限 Microsoft 内部使用。
ContactInformation	包含有关联系人的信息。 注意 contactInformation 可能会在Windows 8.1后更改或无法用于发布。 请改用 “联系人”。
ContactInstantMessageField	定义一个字段，该字段是即时消息 (IM) 地址。
ContactJobInfo	表示联系人的作业信息。
ContactLaunchActionVerbs	在启动应用以对联系人执行操作时提供数据。
ContactList	表示 Contact 对象的列表。
ContactListLimitedWriteOperations	提供应用可以对尚未创建的联系人列表执行的操作。
ContactListSyncConstraints	指定可同步联系人列表数据量的限制。
ContactListSyncManager	提供将联系人信息与服务器同步的功能。
ContactLocationField	包含有关用户位置和地址的信息。 注意 contactLocationField 可能会在Windows 8.1后更改或无法用于发布。 请改用 ContactAddress。
ContactManager	表示源应用可以调用以访问联系人数据的服务。
ContactManagerForUser	表示一个服务，源应用可以调用该服务来访问特定用户的联系人数据。
ContactMatchReason	提供有关搜索结果与查询参数匹配的原因的详细信息。
ContactPanel	表示当用户单击固定到任务栏的联系人时显示的联系人面板。
ContactPanelClosingEventArgs	提供 Closing 事件的事件信息。
ContactPanelLaunchFullAppRequestedEventArgs	提供 LaunchFullAppRequested 事件的事件信息。
ContactPhone	表示有关联系人的电话的信息。
ContactPicker	控制联系人选取器用户界面的打开方式及其显示的信息。
ContactQueryOptions	用于在搜索联系人时指定查询选项。
ContactQueryTextSearch	指定要在 Contact 对象的文本搜索中使用的参数。
ContactReader	用于从 ContactStore 分批读取 Contact 对象，这些对象可能位于本地或远程位置。
ContactSignificantOther	表示有关联系人的重要其他信息。
ContactStore	表示包含联系人的数据库。
ContactStoreNotificationTriggerDetails	保留供将来使用。
ContactWebsite	表示有关联系人的网站的信息。
FullContactCardOptions	指定用于显示完整联系人卡的选项。
KnownContactField	一个静态类，包含联系人字段的名称，用于存储常见请求的信息，如电子邮件地址和电话号码。 注意 在Windows 8.1后，KnownContactField 可能会更改或不可用。 请改用 ContactAddress、 ContactPhone、 ContactConnectedServiceAccount 或 ContactEmail。
PinnedContactIdsQueryResult	提供对查询结果的访问，该查询列出了固定到任务栏或“开始”菜单的所有联系人的 ID。
PinnedContactManager	表示一项服务，源应用可以调用该服务，以便将联系人固定到任务栏或“开始”菜单，并从任务栏或 “开始” 菜单取消固定。 在桌面应用中，在以显示 UI 的方式使用此类的实例之前，需要将该对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

接口

名称	说明
IContactField	指定一个对象，该对象描述一段联系人数据。 注意 Windows 8.1后，IContactField 可能会更改或不可用于发布。 请改用 ContactAddress、 ContactPhone、 ContactSignificantOther、 Contact、 ContactEmail、 ContactConnectedServiceAccount、 ContactWebsite、 ContactJobInfo 或 ContactDate。
IContactFieldFactory	创建包含有关联系人信息的字段。 仅适用于支持“联系人”合约的应用。 注意 IContactFieldFactory 可能会在Windows 8.1后更改或不可用。 请改用 ContactPhone 或 ContactEmail。
IContactInstantMessageFieldFactory	创建包含联系人即时消息帐户信息的字段。 注意 IContactInstantMessageFieldFactory 可能会在Windows 8.1后更改或不可用。 请改用 ContactConnectedServiceAccount。
IContactLocationFieldFactory	为联系人的位置创建字段。 注意 IContactLocationFieldFactory 可能会在Windows 8.1后更改或不可用。 请改用 ContactAddress。

枚举

名称	说明
ContactAddressKind	指定联系人地址的类型。
ContactAnnotationOperations	指定可以对 Contact 执行的操作类型。
ContactAnnotationStoreAccessType	指定应用是可以读取和写入所有注释，还是只能读取和写入属于应用本身的批注。
ContactBatchStatus	指定上次批处理访问操作是否成功，或者是否出现服务器错误。
ContactCardHeaderKind	指定要在联系人卡上显示的标头信息的类型。
ContactCardTabKind	指定要在微型联系人卡上显示的选项卡。
ContactChangeType	指定 ContactChanged 事件发生的更改类型。
ContactDateKind	指定联系人的重要日期类型。
ContactEmailKind	指定联系人的电子邮件地址类型。
ContactFieldCategory	定义联系人数据可以属于的类别。 注意 contactFieldCategory 可能会在Windows 8.1后更改或不可用。 请改用 ContactPhoneKind、 ContactEmailKind 和 ContactAddressKind。
ContactFieldType	定义联系人数据的类型。
ContactListOtherAppReadAccess	指定授予其他应用的联系人读取访问权限的级别。
ContactListOtherAppWriteAccess	指定授予其他应用的联系人写入访问权限的级别。
ContactListSyncStatus	定义 ContactList 同步状态。
ContactMatchReasonKind	定义 联系人 匹配搜索的原因。
ContactNameOrder	指定联系人的姓名顺序。
ContactPhoneKind	指定联系人的电话类型。
ContactQueryDesiredFields	定义联系人上必须存在哪些字段才能匹配搜索操作。
ContactQuerySearchFields	定义要搜索文本匹配项的联系人字段。
ContactQuerySearchScope	定义是搜索本地 ContactStore 还是服务器。
ContactRelationship	定义一个值，该值指示联系人关系的性质，例如配偶、伴侣、兄弟姐妹、父母等。
ContactSelectionMode	指定是要请求整个联系人，还是仅请求特定字段。
ContactStoreAccessType	定义应用对 ContactStore 的访问权限类型。
PinnedContactSurface	指定可在 Windows 用户界面中固定联系人的位置。

注解

有关如何管理联系人的信息，请参阅 管理联系人卡片。

另请参阅

• Windows.ApplicationModel.Contacts.Provider
• 联系人管理器 API 示例
• 联系人选取器应用示例
• 处理联系人操作示例
• 联系人卡片集成示例 (Windows 10)
• 联系人卡片示例 (Windows 10)
• 联系人面板示例
• 我的人员通知示例