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	取得或設定 Boolean 值，指出 ContactList 是否隱藏在使用者介面中。
LimitedWriteOperations	取得 物件，這個物件提供應用程式可以在尚未建立的連絡人清單上執行的作業。
OtherAppReadAccess	取得或設定值，指出系統上其他應用程式的這個 ContactList 讀取存取層級。
OtherAppWriteAccess	取得或設定值，這個值表示系統上其他應用程式的這個 ContactList 寫入存取層級。
SourceDisplayName	取得 ContactList的來源名稱，適合顯示在使用者介面中。
SupportsServerSearch	取得或設定 Boolean 值，指出您是否可以使用這個 ContactList搜尋遠端伺服器。
SyncConstraints	取得 ContactListSyncConstraints ，指出可以同步處理的連絡人清單資料量上限。
SyncManager	取得用來與伺服器通訊的 ContactListSyncManager 。
UserDataAccountId	取得字串，表示這個 ContactList之使用者帳戶的識別碼。

方法

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中的連絡人已變更時。