ContactList 类

定义

命名空间:

Windows.ApplicationModel.Contacts

表示 Contact 对象的列表。

public ref class ContactList sealed

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

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

Public NotInheritable Class ContactList

继承

Object Platform::Object IInspectable ContactList

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

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

注解

调用 ContactStore.CreateContactListAsync 以创建此类的新实例。

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	RegisterSyncManagerAsync
1607	14393	SyncConstraints
1709	16299	GetChangeTracker
1709	16299	LimitedWriteOperations

属性

ChangeTracker	获取此 ContactList 的应用 ContactChangeTracker。
DisplayName	获取或设置适合在用户界面中显示的 ContactList 的名称。
Id	获取此 ContactList 的本地唯一标识符。
IsHidden	获取或设置一个布尔值，该值指示 ContactList 是否隐藏在用户界面中。
LimitedWriteOperations	获取一个 对象，该对象提供应用可以对尚未创建的联系人列表执行的操作。
OtherAppReadAccess	获取或设置一个值，该值指示系统上其他应用的此 ContactList 的读取访问级别。
OtherAppWriteAccess	获取或设置一个值，该值指示系统上其他应用的此 ContactList 的写入访问级别。
SourceDisplayName	获取适合在用户界面中显示的 ContactList 源的名称。
SupportsServerSearch	获取或设置一个布尔值，该值指示是否可以使用此 ContactList 搜索远程服务器。
SyncConstraints	获取 ContactListSyncConstraints ，它指示可以同步的最大联系人列表数据量。
SyncManager	获取用于与服务器通信的 ContactListSyncManager 。
UserDataAccountId	获取表示此 ContactList 的用户数据帐户 ID 的字符串。

方法

DeleteAsync()	异步删除此 ContactList，包括 ContactStore 中的所有 Contact 对象。
DeleteContactAsync(Contact)	从此 ContactList 和 ContactStore 异步删除和单个联系人。
GetChangeTracker(String)	获取一个 ContactChangeTracker，它提供监视 ContactList 中 Contact 对象更改的功能。
GetContactAsync(String)	从 ContactList 异步检索指定的 Contact 对象。
GetContactFromRemoteIdAsync(String)	异步获取由指定的 RemoteId 标识的联系人。
GetContactReader()	获取与此 ContactList 关联的 ContactReader 对象。
GetContactReader(ContactQueryOptions)	获取与此 ContactList 关联的 ContactReader 对象，并使用指定的 ContactQueryOptions。
GetMeContactAsync()	异步获取代表当前用户的 Contact 对象。
RegisterSyncManagerAsync()	将 SyncManager 添加到 ContactList。
SaveAsync()	异步保存此 ContactList。
SaveContactAsync(Contact)	将指定的 联系人 异步保存到 ContactStore。

事件

ContactChanged

更改此 ContactList 中的 联系人 时发生。