Contact Class

Definition

Namespace:

Windows.ApplicationModel.Contacts

Represents a contact.

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

Inheritance

Object Platform::Object IInspectable Contact

Attributes

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)
App capabilities	contactsSystem

Remarks

No matter how you store contact information in your app, you must be able to put that information into a Contact object. This way, other apps that allow users to select contacts can use your app and process the contact information it provides.

For info about how to manage contacts, see Contacts and calendar.

Constructors

Contact()

Creates a new instance of the Contact class.

Properties

Addresses	Gets the contact addresses for a contact.
AggregateId	If this is a raw contact that is part of an aggregate contact, then this property identifies the parent aggregate.
ConnectedServiceAccounts	Gets the connected service accounts for a contact.
ContactListId	Gets a string that identifies the ContactList of which this contact is a member.
DataSuppliers	Gets the data suppliers for a contact. The maximum string length for each data supplier is 50 characters.
DisplayName	Gets the display name for a contact.
DisplayNameOverride	Gets or sets the display name that was manually entered by the user.
DisplayPictureUserUpdateTime	Gets or sets the last time the user updated their display picture.
Emails	Gets the email addresses for a contact.
Fields	Sets the fields that contain information about a contact. Note Fields may be altered or unavailable for releases after Windows 8.1. Instead, use Phones, Emails, Addresses, or ConnectedServiceAccounts.
FirstName	Gets or sets the first name for a contact. The maximum string length for the first name is 64 characters.
FullName	Gets the full name of the Contact.
HonorificNamePrefix	Gets or sets the honorific prefix for the name for a contact. The maximum string length for the honorific prefix is 32 characters.
HonorificNameSuffix	Gets or sets the honorific suffix for the name for a contact. The maximum string length for the honorific suffix is 32 characters.
Id	Gets or sets the identifier for a contact. The maximum string length for the identifier is 256 characters.
ImportantDates	Gets the important dates for a contact.
IsAggregate	Gets a value that indicates whether this is an aggregate Contact.
IsDisplayPictureManuallySet	Gets a Boolean value that indicates whether the user manually set the picture for the Contact.
IsMe	Gets a Boolean value that indicates whether this Contact represents the user logged into the device.
JobInfo	Gets the job info items for a contact.
LargeDisplayPicture	Gets a large version of the display picture for the Contact.
LastName	Gets or sets the last name for a contact. The maximum string length for the last name is 64 characters.
MiddleName	Gets or sets the middle name for a contact. The maximum string length for the middle name is 64 characters.
Name	Sets and gets the name of the contact. Note Name may be altered or unavailable for releases after Windows 8.1. Instead, use FirstName, MiddleName, and LastName.
Nickname	Gets or sets the nickname for the Contact.
Notes	Gets or sets notes for a contact. The maximum string length for notes is 4096 characters.
Phones	Gets info about the phones for a contact.
ProviderProperties	Gets the property set object for the contact.
RemoteId	Gets or sets an ID that can be used by a service provider to access the Contact in their remote system.
RingToneToken	Gets or sets the path to the ringtone file for the Contact.
SignificantOthers	Gets the significant others for a contact.
SmallDisplayPicture	Gets a small version of the display picture for the Contact.
SortName	Gets the name used to sort the contact.
SourceDisplayPicture	Gets or sets the display picture for the Contact in its original size.
TextToneToken	Gets or sets the path to the audio file to play when an SMS/MMS message is received from the Contact.
Thumbnail	Gets or sets a thumbnail image that represents this contact.
Websites	Gets the Web sites for a contact.
YomiDisplayName	Gets the Yomi (phonetic Japanese equivalent) display name for a contact.
YomiFamilyName	Gets or sets the Yomi (phonetic Japanese equivalent) family name for a contact. The maximum string length for the Yomi family name is 120 characters.
YomiGivenName	Gets or sets the Yomi (phonetic Japanese equivalent) given name for a contact. The maximum string length for the Yomi given name is 120 characters.

See also

• Contact manager API sample
• Contact Picker app sample
• Handling Contact Actions sample
• Contact cards sample (Windows 10)