ContactInformation ContactInformation ContactInformation ContactInformation Class

Definition

Represents a contact without an association to a contact store.

public : sealed class ContactInformation : IContactInformation
public sealed class ContactInformation : IContactInformation
Public NotInheritable Class ContactInformation Implements IContactInformation
var contactInformation = new contactInformation();
Attributes
Windows 10 requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Remarks

This class is used to store information about a contact. It has a set of commonly used built-in properties like a family name and a description, and it also allows you to store custom properties as name/value pairs. The StoredContact class shares all of these properties but it requires you to open your app's custom contact store before you can obtain an instance of the class. Many applications will use StoredContact directly and never need to use ContactInformation. If you need to temporarily store contact information without opening your contact store or if you need to parse contact information from a vCard using ParseVcardAsync, you can use ContactInformation and then pass the object to the StoredContact constructor.

Constructors

ContactInformation() ContactInformation() ContactInformation() ContactInformation()

Initializes a new instance of the ContactInformation class.

public : ContactInformation()
public ContactInformation()
Public Sub New()
var contactInformation = new contactInformation();
Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Properties

DisplayName DisplayName DisplayName DisplayName

Gets or sets the display name of a contact.

public : Platform::String DisplayName { get; set; }
public string DisplayName { get; set; }
Public ReadWrite Property DisplayName As string
var string = contactInformation.displayName;
contactInformation.displayName = string;
Value
Platform::String string string string

The display name of a contact.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

DisplayPicture DisplayPicture DisplayPicture DisplayPicture

Gets the display picture of a contact.

public : IRandomAccessStreamReference DisplayPicture { get; }
public IRandomAccessStreamReference DisplayPicture { get; }
Public ReadOnly Property DisplayPicture As IRandomAccessStreamReference
var iRandomAccessStreamReference = contactInformation.displayPicture;
Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Remarks

To set this value, use SetDisplayPictureAsync.

See Also

FamilyName FamilyName FamilyName FamilyName

Gets or sets the family name of a contact.

public : Platform::String FamilyName { get; set; }
public string FamilyName { get; set; }
Public ReadWrite Property FamilyName As string
var string = contactInformation.familyName;
contactInformation.familyName = string;
Value
Platform::String string string string

The family name of a contact.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

GivenName GivenName GivenName GivenName

Gets or sets the given name of a contact.

public : Platform::String GivenName { get; set; }
public string GivenName { get; set; }
Public ReadWrite Property GivenName As string
var string = contactInformation.givenName;
contactInformation.givenName = string;
Value
Platform::String string string string

The given name of a contact.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

HonorificPrefix HonorificPrefix HonorificPrefix HonorificPrefix

Gets or sets the honorific prefix of a contact.

public : Platform::String HonorificPrefix { get; set; }
public string HonorificPrefix { get; set; }
Public ReadWrite Property HonorificPrefix As string
var string = contactInformation.honorificPrefix;
contactInformation.honorificPrefix = string;
Value
Platform::String string string string

The honorific prefix of a contact.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

HonorificSuffix HonorificSuffix HonorificSuffix HonorificSuffix

Gets or sets the honorific suffix of a contact.

public : Platform::String HonorificSuffix { get; set; }
public string HonorificSuffix { get; set; }
Public ReadWrite Property HonorificSuffix As string
var string = contactInformation.honorificSuffix;
contactInformation.honorificSuffix = string;
Value
Platform::String string string string

The honorific suffix of a contact.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Methods

GetDisplayPictureAsync() GetDisplayPictureAsync() GetDisplayPictureAsync() GetDisplayPictureAsync()

Gets the display picture of a contact.

public : IAsyncOperation<IRandomAccessStream> GetDisplayPictureAsync()
public IAsyncOperation<IRandomAccessStream> GetDisplayPictureAsync()
Public Function GetDisplayPictureAsync() As IAsyncOperation( Of IRandomAccessStream )
Windows.Phone.PersonalInformation.ContactInformation.getDisplayPictureAsync().done( /* Your success and error handlers */ );
Returns
Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]
See Also

GetPropertiesAsync() GetPropertiesAsync() GetPropertiesAsync() GetPropertiesAsync()

Gets the properties for a contact as an map of name/value pairs.

public : IAsyncOperation<IMap<Platform::String, Platform::Object>> GetPropertiesAsync()
public IAsyncOperation<IDictionary<string, object>> GetPropertiesAsync()
Public Function GetPropertiesAsync() As IAsyncOperation<IDictionary<string, object>>( Of IMap )
Windows.Phone.PersonalInformation.ContactInformation.getPropertiesAsync().done( /* Your success and error handlers */ );
Returns
IAsyncOperation<IMap<Platform::String, Platform::Object>> IAsyncOperation<IDictionary<string, object>> IAsyncOperation<IDictionary<string, object>> IAsyncOperation<IDictionary<string, object>>

When this method completes, it returns a map/dictionary of name/value pairs (string name, untyped values). If you use Asynchronous programming, the result type is a map or dictionary of these key-value pairs, keyed by string names. (You can use APIs of IMap<Platform::String,Platform::Object> for C++, APIs of IDictionary<String,Object> for .NET.)

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Remarks

When working with the collection that this method returns, use the KnownContactProperties static properties as the key value. This assures that you're asking for known, existing properties.

See Also

ParseVcardAsync(IInputStream) ParseVcardAsync(IInputStream) ParseVcardAsync(IInputStream) ParseVcardAsync(IInputStream)

Parses a vCard from a stream and returns a populated ContactInformation object.

public : static IAsyncOperation<ContactInformation> ParseVcardAsync(IInputStream vcard)
public static IAsyncOperation<ContactInformation> ParseVcardAsync(IInputStream vcard)
Public Static Function ParseVcardAsync(vcard As IInputStream) As IAsyncOperation( Of ContactInformation )
Windows.Phone.PersonalInformation.ContactInformation.parseVcardAsync(vcard).done( /* Your success and error handlers */ );
Parameters
vcard
IInputStream IInputStream IInputStream IInputStream

A stream containing the vCard data.

Returns
Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]
See Also

SetDisplayPictureAsync(IInputStream) SetDisplayPictureAsync(IInputStream) SetDisplayPictureAsync(IInputStream) SetDisplayPictureAsync(IInputStream)

Sets the display picture for a contact using an IInputStream object.

public : IAsyncAction SetDisplayPictureAsync(IInputStream stream)
public IAsyncAction SetDisplayPictureAsync(IInputStream stream)
Public Function SetDisplayPictureAsync(stream As IInputStream) As IAsyncAction
Windows.Phone.PersonalInformation.ContactInformation.setDisplayPictureAsync(stream).done( /* Your success and error handlers */ );
Parameters
stream
IInputStream IInputStream IInputStream IInputStream

The stream containing the image data.

Returns

An asynchronous action. If you use Asynchronous programming, the result type is void.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]
See Also

ToVcardAsync() ToVcardAsync() ToVcardAsync() ToVcardAsync()

Retrieves a vCard representation of the contact using the vCard version 3.0 format.

public : IAsyncOperation<IRandomAccessStream> ToVcardAsync()
public IAsyncOperation<IRandomAccessStream> ToVcardAsync()
Public Function ToVcardAsync() As IAsyncOperation( Of IRandomAccessStream )
Windows.Phone.PersonalInformation.ContactInformation.toVcardAsync().done( /* Your success and error handlers */ );
Returns

When this method completes, it returns a stream containing the vCard data. If you use Asynchronous programming, the result type is IRandomAccessStream, which is the data.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Remarks

vCard is a file format standard for electronic business cards.

See Also

ToVcardAsync(VCardFormat) ToVcardAsync(VCardFormat) ToVcardAsync(VCardFormat) ToVcardAsync(VCardFormat)

Retrieves a vCard representation of the contact using the specified vCard format.

public : IAsyncOperation<IRandomAccessStream> ToVcardAsync(VCardFormat format)
public IAsyncOperation<IRandomAccessStream> ToVcardAsync(VCardFormat format)
Public Function ToVcardAsync(format As VCardFormat) As IAsyncOperation( Of IRandomAccessStream )
Windows.Phone.PersonalInformation.ContactInformation.toVcardAsync(format).done( /* Your success and error handlers */ );
Parameters
format
VCardFormat VCardFormat VCardFormat VCardFormat

The format that the returned vCard will use.

Returns

When this method completes, it returns a stream containing the vCard data. If you use Asynchronous programming, the result type is IRandomAccessStream, which is the data.

Additional features and requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)
Capabilities
ID_CAP_CONTACTS [Windows Phone]

Remarks

vCard is a file format standard for electronic business cards.

See Also

See Also