Windows.ApplicationModel.Contacts 命名空間

可讓應用程式選取並取得連絡人的相關資訊。

重要

此命名空間包含Windows 8.1的一些成員，以及Windows 8.1之後可能無法使用的其他成員。 這兩種類型的成員無法一起運作，而且從相同的應用程式呼叫這兩種成員會導致應用程式失敗。 建議您只呼叫未標示為無法使用警告的成員。

類別

AggregateContactManager	提供將個別 (原始) 連絡人連結至單一匯總連絡人的功能。
Contact	代表連絡人。
ContactAddress	代表連絡人的位址。
ContactAnnotation	提供標記現有使用者連絡人的方法，並提供其他資訊，指定您的應用程式可以為此特定連絡人執行一些 SupportedOperations 。
ContactAnnotationList	代表 ContactAnnotation 物件的清單。
ContactAnnotationStore	表示包含連絡人批註的資料存放區。
ContactBatch	代表 連絡人 物件和伺服器搜尋狀態的群組。
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	指定要在 連絡人 物件的文字搜尋中使用的參數。
ContactReader	用來從可能位於本機或遠端的ContactStore，以批次方式讀取Contact 物件。
ContactSignificantOther	代表連絡人的其他相關資訊。
ContactStore	表示包含連絡人的資料庫。
ContactStoreNotificationTriggerDetails	保留供未來使用。
ContactWebsite	代表連絡人的網站相關資訊。
FullContactCardOptions	指定顯示完整連絡人卡片的選項。
KnownContactField	靜態類別，包含連絡人欄位的名稱，用於儲存常用要求的資訊，例如電子郵件地址和電話號碼。 注意 KnownContactField 可能會在Windows 8.1之後變更或無法使用版本。 請改用 ContactAddress、 ContactPhone、 ContactConnectedServiceAccount或 ContactEmail。
PinnedContactIdsQueryResult	提供查詢結果的存取權，其中列出釘選到工作列或 [開始] 功能表的所有連絡人識別碼。
PinnedContactManager	表示來源應用程式可以從工作列或 [ 開始 ] 功能表呼叫釘選和取消釘選連絡人的服務。 在傳統型應用程式中，在以顯示 UI 的方式使用這個類別的實例之前，您必須將物件與其擁有者的視窗控制碼產生關聯。 如需詳細資訊和程式碼範例，請參閱 顯示相依于 CoreWindow 的 WinRT UI 物件。

介面

IContactField	指定描述連絡人資料片段的物件。 注意 IContactField 可能會在Windows 8.1之後變更或無法使用。 請改用 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	指定您可以使用 連絡人執行的作業類型。
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)
• 連絡人面板範例
• 我的人員通知範例