ContactManager Class

Definition

Namespace:
Windows.ApplicationModel.Contacts
Edit

Represents a service that source apps can call to access contact data.

public ref class ContactManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics3, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics2, 65536, Windows.Foundation.UniversalApiContract)]
class ContactManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics3, 65536, "Windows.Foundation.UniversalApiContract")]
class ContactManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics3, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics4, 196608, "Windows.Foundation.UniversalApiContract")]
class ContactManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics3, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics4, 196608, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Static(Windows.ApplicationModel.Contacts.IContactManagerStatics5, 262144, "Windows.Foundation.UniversalApiContract")]
class ContactManager abstract sealed
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics3), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics2), 65536, typeof(Windows.Foundation.UniversalApiContract))]
public static class ContactManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics3), 65536, "Windows.Foundation.UniversalApiContract")]
public static class ContactManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics3), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics4), 196608, "Windows.Foundation.UniversalApiContract")]
public static class ContactManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics3), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics4), 196608, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.ApplicationModel.Contacts.IContactManagerStatics5), 262144, "Windows.Foundation.UniversalApiContract")]
public static class ContactManager
Public Class ContactManager
Inheritance
Object
ContactManager
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute StaticAttribute

Windows 10 requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)
App capabilities
contactsSystem

Remarks

All relevant methods of this class are static methods.

For info about how to manage contacts, see Contacts and calendar.

Version history

Windows version SDK version Value added
1607 14393 GetForUser
1703 15063 IncludeMiddleNameInSystemDisplayAndSort
1703 15063 IsShowFullContactCardSupportedAsync

Properties

IncludeMiddleNameInSystemDisplayAndSort

Gets or sets a Boolean that indicates whether the middle name of a contact is included in the DisplayName and SortName of a contact.
SystemDisplayNameOrder

Gets or sets the display name order.
SystemSortOrder

Gets or sets the sort order.

Methods

ConvertContactToVCardAsync(Contact)

Asynchronously converts a Contact to a vCard.
ConvertContactToVCardAsync(Contact, UInt32)

Asynchronously converts a Contact to a vCard.
ConvertVCardToContactAsync(IRandomAccessStreamReference)

Asynchronously converts a vCard to a Contact.
GetForUser(User)

Gets the ContactManagerForUser object for the specified user.
IsShowContactCardSupported()

Gets a Boolean value that indicates whether the ShowContactCard method is supported on the current platform.
IsShowDelayLoadedContactCardSupported()

Gets a Boolean value that indicates whether the ShowDelayLoadedContactCard method is supported on the current platform.
IsShowFullContactCardSupportedAsync()

Gets a Boolean value that indicates whether the ShowFullContactCard method is supported on the current platform.
RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType)

Asynchronously requests access to the ContactAnnotationStore.
RequestStoreAsync()

Retrieves a ContactStore object that enables searching or retrieving contacts on the device.
RequestStoreAsync(ContactStoreAccessType)

Retrieves a ContactStore object that enables searching or retrieving contacts on the device.
ShowContactCard(Contact, Rect)

Queries the operating system for a user’s contact and shows the contact data in a contact card.
ShowContactCard(Contact, Rect, Placement)

Queries the operating system for a user’s contact and shows the contact data in a contact card.
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)

Shows a contact card with the specified parameters.
ShowDelayLoadedContactCard(Contact, Rect, Placement)

Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.
ShowDelayLoadedContactCard(Contact, Rect, Placement, ContactCardOptions)

Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.
ShowFullContactCard(Contact, FullContactCardOptions)

Queries the operating system for a user’s contact and shows the contact data in a full contact card.

Applies to

See also