Contact Class

Definition

Represents a contact.

public ref class Contact sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class Contact final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class Contact
[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

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.

Applies to

See also