Contact​Information Contact​Information Contact​Information Class

Definition

Represents a contact without an association to a contact store.

public sealed class ContactInformation : IContactInformationpublic sealed class ContactInformation : IContactInformationPublic NotInheritable Class ContactInformation Implements IContactInformation
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 @Windows.Phone.PersonalInformation.StoredContact.#ctor(Windows.Phone.PersonalInformation.ContactStore,Windows.Phone.PersonalInformation.ContactInformation)?text=StoredContact constructor.

Constructors

ContactInformation() ContactInformation() ContactInformation()

Initializes a new instance of the ContactInformation class.

public ContactInformation()public ContactInformation()Public Sub New()
Attributes
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

Gets or sets the display name of a contact.

public string DisplayName { get; set; }public string DisplayName { get; set; }Public ReadWrite Property DisplayName As string
Value
string string string

The display name of a contact.

Attributes
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

Gets the display picture of a contact.

public IRandomAccessStreamReference DisplayPicture { get; }public IRandomAccessStreamReference DisplayPicture { get; }Public ReadOnly Property DisplayPicture As IRandomAccessStreamReference
Attributes
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.

FamilyName FamilyName FamilyName

Gets or sets the family name of a contact.

public string FamilyName { get; set; }public string FamilyName { get; set; }Public ReadWrite Property FamilyName As string
Value
string string string

The family name of a contact.

Attributes
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

Gets or sets the given name of a contact.

public string GivenName { get; set; }public string GivenName { get; set; }Public ReadWrite Property GivenName As string
Value
string string string

The given name of a contact.

Attributes
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

Gets or sets the honorific prefix of a contact.

public string HonorificPrefix { get; set; }public string HonorificPrefix { get; set; }Public ReadWrite Property HonorificPrefix As string
Value
string string string

The honorific prefix of a contact.

Attributes
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

Gets or sets the honorific suffix of a contact.

public string HonorificSuffix { get; set; }public string HonorificSuffix { get; set; }Public ReadWrite Property HonorificSuffix As string
Value
string string string

The honorific suffix of a contact.

Attributes
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()

Gets the display picture of a contact.

public IAsyncOperation<IRandomAccessStream> GetDisplayPictureAsync()public IAsyncOperation<IRandomAccessStream> GetDisplayPictureAsync()Public Function GetDisplayPictureAsync() As IAsyncOperation( Of IRandomAccessStream )
Returns

A stream containing the image data.

Attributes
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()

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

public IAsyncOperation<IMap<string, object>> GetPropertiesAsync()public IAsyncOperation<IMap<string, object>> GetPropertiesAsync()Public Function GetPropertiesAsync() As IAsyncOperation( Of IMapstring, object )
Returns

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.)

Attributes
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)

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 )
Parameters
vcard
IInputStream IInputStream IInputStream

A stream containing the vCard data.

Returns

When this method completes, it returns a ContactInformation object populated with the data from the vCard. If you use Asynchronous programming, the result type is ContactInformation.

Attributes
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)

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
Parameters
stream
IInputStream IInputStream IInputStream

The stream containing the image data.

Returns

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

Attributes
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()

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 )
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.

Attributes
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)

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 )
Parameters
format
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.

Attributes
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