Contact 類別

定義

命名空間:

Windows.ApplicationModel.Contacts

代表連絡人。

public ref class Contact sealed

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

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

function Contact()

Public NotInheritable Class Contact

繼承

Object Platform::Object IInspectable Contact

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

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

備註

無論您如何在應用程式中儲存連絡資訊，您都必須能夠將該資訊放入 Contact 物件中。 如此一來，允許使用者選取連絡人的其他應用程式可以使用您的應用程式，並處理它所提供的連絡資訊。

如需如何管理連絡人的詳細資訊，請參閱 連絡人和行事曆。

建構函式

Contact()

建立 Contact 類別的新實例。

屬性

Addresses	取得連絡人的連絡人位址。
AggregateId	如果這是屬於匯總連絡人一部分的原始連絡人，則此屬性會識別父匯總。
ConnectedServiceAccounts	取得連絡人的已連線服務帳戶。
ContactListId	取得字串，識別此連絡人所屬的 ContactList 。
DataSuppliers	取得連絡人的資料供應商。 每個資料供應商的最大字串長度為 50 個字元。
DisplayName	取得連絡人的顯示名稱。
DisplayNameOverride	取得或設定使用者手動輸入的顯示名稱。
DisplayPictureUserUpdateTime	取得或設定使用者上次更新其顯示圖片的時間。
Emails	取得連絡人的電子郵件地址。
Fields	設定包含連絡人相關資訊的欄位。 注意 Fields在Windows 8.1之後，版本可能會變更或無法使用。 請改用 電話、 電子郵件、 位址或 ConnectedServiceAccounts。
FirstName	取得或設定連絡人的名字。 名字的最大字串長度為 64 個字元。
FullName	取得 連絡人的完整名稱。
HonorificNamePrefix	取得或設定連絡人名稱的接受前置詞。 接受前置詞的最大字串長度為 32 個字元。
HonorificNameSuffix	取得或設定連絡人名稱的接受尾碼。 接受尾碼的最大字串長度為 32 個字元。
Id	取得或設定連絡人的識別碼。 識別碼的最大字串長度為 256 個字元。
ImportantDates	取得連絡人的重要日期。
IsAggregate	取得值，這個值表示這是否為匯總 連絡人。
IsDisplayPictureManuallySet	取得布林值，指出使用者是否手動設定 連絡人的圖片。
IsMe	取得布林值，指出此 連絡人 是否代表登入裝置的使用者。
JobInfo	取得連絡人的作業資訊專案。
LargeDisplayPicture	取得 連絡人顯示圖片的大型版本。
LastName	取得或設定連絡人的姓氏。 姓氏的最大字串長度為 64 個字元。
MiddleName	取得或設定連絡人的中間名。 中間名的最大字串長度為 64 個字元。
Name	設定並取得連絡人的名稱。 注意 在Windows 8.1之後，版本可能會變更或無法使用名稱。 請改用 FirstName、 MiddleName和 LastName。
Nickname	取得或設定 連絡人的昵稱。
Notes	取得或設定連絡人的附注。 附注的最大字串長度為 4096 個字元。
Phones	取得連絡人手機的相關資訊。
ProviderProperties	取得連絡人的屬性集物件。
RemoteId	取得或設定服務提供者可用來存取其遠端系統中 連絡人 的識別碼。
RingToneToken	取得或設定 連絡人的響鈴檔案路徑。
SignificantOthers	取得連絡人的重要其他人。
SmallDisplayPicture	取得連絡人的小型顯示圖片版本。
SortName	取得用來排序連絡人的名稱。
SourceDisplayPicture	取得或設定 連絡人 的原始大小顯示圖片。
TextToneToken	取得或設定從 連絡人收到 SMS/MMS 訊息時要播放的音訊檔案路徑。
Thumbnail	取得或設定代表此連絡人的縮圖影像。
Websites	取得連絡人的網站。
YomiDisplayName	取得連絡人的 Yomi (注音符號日文對等) 顯示名稱。
YomiFamilyName	取得或設定連絡人的 Yomi (注音符號日文對等) 系列名稱。 Yomi 系列名稱的最大字串長度為 120 個字元。
YomiGivenName	取得或設定 Yomi (注音符號日文對等) 連絡人的名稱。 Yomi 指定名稱的最大字串長度為 120 個字元。

另請參閱

• 連絡人管理員 API 範例
• 連絡人選擇器應用程式範例
• 處理連絡人動作範例
• 連絡人卡片範例 (Windows 10)