ContactInformation.Locations | locations property

Applies to Windows and Windows Phone

[ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact. ]

A read-only list of locations stored with the contact.

Syntax


Public ReadOnly Property Locations As IReadOnlyList(Of ContactLocationField)

Property value

Type: IVectorView<ContactLocationField> [JavaScript/C++] | System.Collections.Generic.IReadOnlyList<ContactLocationField> [.NET]

A read-only list of locations.

Remarks

Use the Locations property to access a contact's address and other information from a ContactInformation object.

Examples

This code demonstrates the use of the Locations property.


function getLocation() {
    var picker = Windows.ApplicationModel.Contacts.ContactPicker();
    picker.commitButtonText = "Select";
    picker.selectionMode = Windows.ApplicationModel.Contacts.ContactSelectionMode.fields;
    picker.desiredFields.append(Windows.ApplicationModel.Contacts.KnownContactField.location);
    picker.pickSingleContactAsync().then(function (contact) {
        var contactElement = document.createElement("div");
        var contactData = contact.name + "<br/>";
        contactData += contact.locations[0].city + "<br/>";
        contactData += contact.locations[0].country + "<br/>";
        contactData += contact.locations[0].postalcode + "<br/>";
        contactData += contact.locations[0].region = "<br/>";
        contactData += contact.locations[0].street + "<br/>";
        contactData += contact.instantMessages[0].category + "<br/>";
        contactData += contact.instantMessages[0].type;
        contactElement.innerHTML = contactData;
        document.body.appendChild(contactElement);
    });
}


Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

Metadata

Windows.winmd

See also

ContactInformation

 

 

Show:
© 2014 Microsoft