Contact Contact Contact Contact Class

Creates a new instance of the Contact class.

public : Contact()public Contact()Public Sub New()// You can use this method in JavaScript.

Gets the contact addresses for a contact.

public : IVector<ContactAddress> Addresses { get; }public IList<ContactAddress> Addresses { get; }Public ReadOnly Property Addresses As IList<ContactAddress>// You can use this property in JavaScript.

If this is a raw contact that is part of an aggregate contact, then this property identifies the parent aggregate.

public : PlatForm::String AggregateId { get; }public string AggregateId { get; }Public ReadOnly Property AggregateId As string// You can use this property in JavaScript.

Gets the connected service accounts for a contact.

public : IVector<ContactConnectedServiceAccount> ConnectedServiceAccounts { get; }public IList<ContactConnectedServiceAccount> ConnectedServiceAccounts { get; }Public ReadOnly Property ConnectedServiceAccounts As IList<ContactConnectedServiceAccount>// You can use this property in JavaScript.

Gets a string that identifies the ContactList to which this contact is a member.

public : PlatForm::String ContactListId { get; }public string ContactListId { get; }Public ReadOnly Property ContactListId As string// You can use this property in JavaScript.

Gets the data suppliers for a contact. The maximum string length for each data supplier is 50 characters.

public : IVector<string> DataSuppliers { get; }public IList<string> DataSuppliers { get; }Public ReadOnly Property DataSuppliers As IList<string>// You can use this property in JavaScript.

Gets the display name for a contact.

public : PlatForm::String DisplayName { get; }public string DisplayName { get; }Public ReadOnly Property DisplayName As string// You can use this property in JavaScript.

Remarks

Windows calculates the DisplayName property by using the values from the FirstName, MiddleName, and LastName properties if any are specified. If these values aren't available, Windows uses the Yomi (phonetic Japanese equivalent) name values (YomiGivenName and YomiFamilyName ). The calculation for DisplayName takes into account different locale hints such as script of the text in the names, resource context, and default user locale to determine the proper formatting template for the name.

Gets or sets the display that was manually entered by the user.

public : PlatForm::String DisplayNameOverride { get; set; }public string DisplayNameOverride { get; set; }Public ReadWrite Property DisplayNameOverride As string// You can use this property in JavaScript.

Gets or sets the last time the user updated their display picture.

public : DateTime DisplayPictureUserUpdateTime { get; set; }public DateTimeOffset DisplayPictureUserUpdateTime { get; set; }Public ReadWrite Property DisplayPictureUserUpdateTime As DateTimeOffset// You can use this property in JavaScript.

Gets the email addresses for a contact.

public : IVector<ContactEmail> Emails { get; }public IList<ContactEmail> Emails { get; }Public ReadOnly Property Emails As IList<ContactEmail>// You can use this property in JavaScript.

Sets the fields that contain information about a contact.

public : IVector<IContactField> Fields { get; }public IList<IContactField> Fields { get; }Public ReadOnly Property Fields As IList<IContactField>// You can use this property in JavaScript.

Examples

These functions show how you can add different fields to a Contact object.

function appendField(fields, value, type, category) {
    if (value) {
        fields.append(new Windows.ApplicationModel.Contacts.ContactField(value, type, category));
    }
}

function appendEmail(fields, email, category) {
    // Adds a new email to the contact fields vector
    appendField(fields, email, Windows.ApplicationModel.Contacts.ContactFieldType.email, category);
}

function appendPhoneNumber(fields, phone, category) {
    // Adds a new phone number to the contact fields vector
    appendField(fields, phone, Windows.ApplicationModel.Contacts.ContactFieldType.phoneNumber, category);
}

function appendAddress(fields, address, category) {
    // Adds a new address to the contact fields vector
    if (address) {
        fields.append(new Windows.ApplicationModel.Contacts.ContactLocationField(
                        address.full, category, address.street, address.city, address.state, "", address.zipCode));
    }
}

Remarks

The ContactFieldCategory and ContactFieldType classes provide information about what kind of information you can put into a field.

Gets and sets the first name for a contact. The maximum string length for the first name is 64 characters.

public : PlatForm::String FirstName { get; set; }public string FirstName { get; set; }Public ReadWrite Property FirstName As string// You can use this property in JavaScript.

See Also

NameNameNameName

Gets the full name of the Contact.

public : PlatForm::String FullName { get; }public string FullName { get; }Public ReadOnly Property FullName As string// You can use this property in JavaScript.

Gets and sets the honorific prefix for the name for a contact. The maximum string length for the honorific prefix is 32 characters.

public : PlatForm::String HonorificNamePrefix { get; set; }public string HonorificNamePrefix { get; set; }Public ReadWrite Property HonorificNamePrefix As string// You can use this property in JavaScript.

Remarks

Common name prefixes are Ms, Miss, Mrs, Mr, Dr, and so on.

Gets and sets the honorific suffix for the name for a contact. The maximum string length for the honorific suffix is 32 characters.

public : PlatForm::String HonorificNameSuffix { get; set; }public string HonorificNameSuffix { get; set; }Public ReadWrite Property HonorificNameSuffix As string// You can use this property in JavaScript.

Remarks

A suffix follows the contact's name and provides additional info about the contact, like an academic degree (M.D. for medical doctor).

Gets and sets the identifier for a contact. The maximum string length for the identifier is 256 characters.

public : PlatForm::String Id { get; set; }public string Id { get; set; }Public ReadWrite Property Id As string// You can use this property in JavaScript.

Gets the important dates for a contact.

public : IVector<ContactDate> ImportantDates { get; }public IList<ContactDate> ImportantDates { get; }Public ReadOnly Property ImportantDates As IList<ContactDate>// You can use this property in JavaScript.

Gets a Boolean value indicating of this is an aggregate Contact.

public : PlatForm::Boolean IsAggregate { get; }public bool IsAggregate { get; }Public ReadOnly Property IsAggregate As bool// You can use this property in JavaScript.

Gets a Boolean value indicating if the user manually set the picture for the Contact.

public : PlatForm::Boolean IsDisplayPictureManuallySet { get; }public bool IsDisplayPictureManuallySet { get; }Public ReadOnly Property IsDisplayPictureManuallySet As bool// You can use this property in JavaScript.

Gets a Boolean value indicating if this Contact represents the user logged into the device.

public : PlatForm::Boolean IsMe { get; }public bool IsMe { get; }Public ReadOnly Property IsMe As bool// You can use this property in JavaScript.

Gets the job info items for a contact.

public : IVector<ContactJobInfo> JobInfo { get; }public IList<ContactJobInfo> JobInfo { get; }Public ReadOnly Property JobInfo As IList<ContactJobInfo>// You can use this property in JavaScript.

Gets a large version of the display picture for the Contact.

public : IRandomAccessStreamReference LargeDisplayPicture { get; }public IRandomAccessStreamReference LargeDisplayPicture { get; }Public ReadOnly Property LargeDisplayPicture As IRandomAccessStreamReference// You can use this property in JavaScript.

Gets and sets the last name for a contact. The maximum string length for the last name is 64 characters.

public : PlatForm::String LastName { get; set; }public string LastName { get; set; }Public ReadWrite Property LastName As string// You can use this property in JavaScript.

See Also

NameNameNameName

Gets and sets the middle name for a contact. The maximum string length for the middle name is 64 characters.

public : PlatForm::String MiddleName { get; set; }public string MiddleName { get; set; }Public ReadWrite Property MiddleName As string// You can use this property in JavaScript.

See Also

NameNameNameName

Sets and gets the name of the contact.

public : PlatForm::String Name { get; set; }public string Name { get; set; }Public ReadWrite Property Name As string// You can use this property in JavaScript.

Examples

This example shows a function taking the name property and returning the first and last names of the contact.

function getFirstAndLastName(contact) {
    var name = contact.name;
    if (name.indexOf(" ") != -1) {
        var firstAndLast = name.split(" ");
        return {
            first: firstAndLast[0],
            last: firstAndLast[1]
        };
    } else {
        return null;
    }
}

Remarks

An app can set the name property to any value that matches the name of a contact. We recommend that you set this value to contain both the first and last names of the contact, if that information is available.

Gets or sets the nickname for the Contact.

public : PlatForm::String Nickname { get; set; }public string Nickname { get; set; }Public ReadWrite Property Nickname As string// You can use this property in JavaScript.

Gets and sets notes for a contact. The maximum string length for notes is 4096 characters.

public : PlatForm::String Notes { get; set; }public string Notes { get; set; }Public ReadWrite Property Notes As string// You can use this property in JavaScript.

Gets info about the phones for a contact.

public : IVector<ContactPhone> Phones { get; }public IList<ContactPhone> Phones { get; }Public ReadOnly Property Phones As IList<ContactPhone>// You can use this property in JavaScript.

Gets the property set object for the contact.

public : IPropertySet ProviderProperties { get; }public IPropertySet ProviderProperties { get; }Public ReadOnly Property ProviderProperties As IPropertySet// You can use this property in JavaScript.

See Also

IPropertySetIPropertySetIPropertySetIPropertySet

Gets or sets an ID that can be used by a service provider to access the Contact in their remote system.

public : PlatForm::String RemoteId { get; set; }public string RemoteId { get; set; }Public ReadWrite Property RemoteId As string// You can use this property in JavaScript.

Gets or puts the path to the ringtone file for the Contact.

public : PlatForm::String RingToneToken { get; set; }public string RingToneToken { get; set; }Public ReadWrite Property RingToneToken As string// You can use this property in JavaScript.

Gets the significant others for a contact.

public : IVector<ContactSignificantOther> SignificantOthers { get; }public IList<ContactSignificantOther> SignificantOthers { get; }Public ReadOnly Property SignificantOthers As IList<ContactSignificantOther>// You can use this property in JavaScript.

Gets a small version of the display picture for the Contact.

public : IRandomAccessStreamReference SmallDisplayPicture { get; }public IRandomAccessStreamReference SmallDisplayPicture { get; }Public ReadOnly Property SmallDisplayPicture As IRandomAccessStreamReference// You can use this property in JavaScript.

Gets the name used to sort the contact.

public : PlatForm::String SortName { get; }public string SortName { get; }Public ReadOnly Property SortName As string// You can use this property in JavaScript.

Gets or sets the display picture for the Contact in its original size.

public : IRandomAccessStreamReference SourceDisplayPicture { get; set; }public IRandomAccessStreamReference SourceDisplayPicture { get; set; }Public ReadWrite Property SourceDisplayPicture As IRandomAccessStreamReference// You can use this property in JavaScript.

Remarks

The SmallDisplayPicture, LargeDisplayPicture and Thumbnail are generated from this picture.

Gets or puts the path to the audio file to play when an SMS/MMS message is received from the Contact.

public : PlatForm::String TextToneToken { get; set; }public string TextToneToken { get; set; }Public ReadWrite Property TextToneToken As string// You can use this property in JavaScript.

Gets or sets a thumbnail image that represents this contact.

public : IRandomAccessStreamReference Thumbnail { get; set; }public IRandomAccessStreamReference Thumbnail { get; set; }Public ReadWrite Property Thumbnail As IRandomAccessStreamReference// You can use this property in JavaScript.

Gets the Web sites for a contact.

public : IVector<ContactWebsite> Websites { get; }public IList<ContactWebsite> Websites { get; }Public ReadOnly Property Websites As IList<ContactWebsite>// You can use this property in JavaScript.

Gets the Yomi (phonetic Japanese equivalent) display name for a contact.

public : PlatForm::String YomiDisplayName { get; }public string YomiDisplayName { get; }Public ReadOnly Property YomiDisplayName As string// You can use this property in JavaScript.

Remarks

Windows calculates the YomiDisplayName property by using the values from the YomiGivenName and YomiFamilyName properties. The calculation for YomiDisplayName takes into account different locale hints such as script of the text in the names, resource context, and default user locale to determine the proper formatting template for the name.

Gets the Yomi (phonetic Japanese equivalent) family name for a contact. The maximum string length for the Yomi family name is 120 characters.

public : PlatForm::String YomiFamilyName { get; set; }public string YomiFamilyName { get; set; }Public ReadWrite Property YomiFamilyName As string// You can use this property in JavaScript.

Gets the Yomi (phonetic Japanese equivalent) given name for a contact. The maximum string length for the Yomi given name is 120 characters.

public : PlatForm::String YomiGivenName { get; set; }public string YomiGivenName { get; set; }Public ReadWrite Property YomiGivenName As string// You can use this property in JavaScript.