ContactInformation 類別

定義

命名空間:

Windows.ApplicationModel.Contacts

包含連絡人的相關資訊。

注意

contactInformation 可能會在Windows 8.1之後變更或無法使用。 請改用 連絡人。

public ref class ContactInformation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ContactInformation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ContactInformation

Public NotInheritable Class ContactInformation

繼承

Object Platform::Object IInspectable ContactInformation

屬性

ContractVersionAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能	contactsSystem

備註

注意

因為您不會在Windows 8.1和更新版本中使用PickSingleContactAsync和PickMultipleContactsAsync，所以不會在Windows 8.1和更新版本中具現化 ContactInformation 物件。下表顯示現有的 Windows 8 ContactInformation 屬性及其對等Windows 8.1 Contact屬性。

Windows 8 ContactInformation 屬性	Windows 8.1 Contact 屬性
Contact.Name	Contact.Name
Contact.Thumbnail	Contact.Thumbnail
Contact.Fields	Contact.Emails
Contact.Fields where ContactField.Value = Address and ContactField.Category = ContactFieldCategory.Home or ContactFieldCategory.Other	Contact.Addresses
Contact.Fields	Contact.Phone
ContactField.Value	ContactEmail.Address
ContactField.Category (Home，Work，Other)	ContactEmail.Kind (Personal，Work，Other)
ContactField.Value	ContactPhone.Number
ContactField.Category (Home、Work、Mobile、Other)	ContactPhone.Kind (Home，Work，Mobile，Other)
Contact.Fields where ContactField.Value = CompanyAddress and ContactField.Category = ContactFieldCategory.Work	ContactJobInfo.CompanyAddress

一般而言，您會以非同步方法和/或函式呼叫的結果來存取 ContactInformation 物件。 例如，這兩個靜態方法 PickSingleContactAsync 和 PickMultipleContactsAsync 都會傳回代表所選連絡人的 ContactInformation 物件。

當您的應用程式收到連絡人提供者的連絡人資訊時，每個連絡人的資料都會在 ContactInformation 物件中傳回。

屬性

CustomFields	與連絡人一起儲存之自訂欄位的唯讀清單。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。
Emails	與連絡人一起儲存的電子郵件地址唯讀清單。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。
InstantMessages	與連絡人一起儲存之立即訊息帳戶的唯讀清單。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。
Locations	與連絡人一起儲存之位置的唯讀清單。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。
Name	連絡人的名稱。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。
PhoneNumbers	與連絡人一起儲存的電話號碼唯讀清單。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。

方法

GetThumbnailAsync()	取得連絡人的縮圖影像。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。
QueryCustomFields(String)	可讓您取得與連絡人一起儲存之自訂欄位的值。 注意 contactInformation可能會在Windows 8.1之後變更或無法使用發行。 請改用 連絡人。