AggregateContactManager AggregateContactManager AggregateContactManager AggregateContactManager Class

Definition

Provides functionality for linking individual (raw) contacts across services together into a single aggregate contact.

public : sealed class AggregateContactManager : IAggregateContactManager, IAggregateContactManager2
public sealed class AggregateContactManager : IAggregateContactManager, IAggregateContactManager2
Public NotInheritable Class AggregateContactManager Implements IAggregateContactManager, IAggregateContactManager2
// This class does not provide a public constructor.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
contactsSystem

Remarks

All relevant methods of this class are static methods.

Methods

FindRawContactsAsync(Contact) FindRawContactsAsync(Contact) FindRawContactsAsync(Contact) FindRawContactsAsync(Contact)

Returns the list of individual (raw) contacts from the specified aggregate contact.

public : IAsyncOperation<IVectorView<Contact>> FindRawContactsAsync(Contact contact)
public IAsyncOperation<IReadOnlyList<Contact>> FindRawContactsAsync(Contact contact)
Public Function FindRawContactsAsync(contact As Contact) As IAsyncOperation<IReadOnlyList<Contact>>( Of IVectorView )
Windows.ApplicationModel.Contacts.AggregateContactManager.findRawContactsAsync(contact).done( /* Your success and error handlers */ );
Parameters
contact
Contact Contact Contact Contact

The aggregate contact from which to extract the list of raw contacts.

Returns
IAsyncOperation<IVectorView<Contact>> IAsyncOperation<IReadOnlyList<Contact>> IAsyncOperation<IReadOnlyList<Contact>> IAsyncOperation<IReadOnlyList<Contact>>

The list of individual (raw) contacts from the specified aggregate contact.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
contactsSystem

SetRemoteIdentificationInformationAsync(String, String, String) SetRemoteIdentificationInformationAsync(String, String, String) SetRemoteIdentificationInformationAsync(String, String, String) SetRemoteIdentificationInformationAsync(String, String, String)

Sets the identifier that specifies the remote contacts to link together with the contact data on your device.

public : IAsyncAction SetRemoteIdentificationInformationAsync(Platform::String contactListId, Platform::String remoteSourceId, Platform::String accountId)
public IAsyncAction SetRemoteIdentificationInformationAsync(String contactListId, String remoteSourceId, String accountId)
Public Function SetRemoteIdentificationInformationAsync(contactListId As String, remoteSourceId As String, accountId As String) As IAsyncAction
Windows.ApplicationModel.Contacts.AggregateContactManager.setRemoteIdentificationInformationAsync(contactListId, remoteSourceId, accountId).done( /* Your success and error handlers */ );
Parameters
contactListId
Platform::String String String String

The remote contact list identifier.

remoteSourceId
Platform::String String String String

The identifier for the remote service, for example, “EXCH” for exchange accounts.

accountId
Platform::String String String String

The unique roaming identifier of the account for the network.

Returns
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)
Capabilities
contactsSystem

TryLinkContactsAsync(Contact, Contact) TryLinkContactsAsync(Contact, Contact) TryLinkContactsAsync(Contact, Contact) TryLinkContactsAsync(Contact, Contact)

Asynchronously attempts to link contacts together to make an aggregate contact.

public : IAsyncOperation<Contact> TryLinkContactsAsync(Contact primaryContact, Contact secondaryContact)
public IAsyncOperation<Contact> TryLinkContactsAsync(Contact primaryContact, Contact secondaryContact)
Public Function TryLinkContactsAsync(primaryContact As Contact, secondaryContact As Contact) As IAsyncOperation( Of Contact )
Windows.ApplicationModel.Contacts.AggregateContactManager.tryLinkContactsAsync(primaryContact, secondaryContact).done( /* Your success and error handlers */ );
Parameters
primaryContact
Contact Contact Contact Contact

The first contact to link.

secondaryContact
Contact Contact Contact Contact

The second contact to link to the primaryContact.

Returns
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
contactsSystem

Remarks

The primaryContact and secondaryContact objects can be any combination of raw and aggregate contacts.

TrySetPreferredSourceForPictureAsync(Contact, Contact) TrySetPreferredSourceForPictureAsync(Contact, Contact) TrySetPreferredSourceForPictureAsync(Contact, Contact) TrySetPreferredSourceForPictureAsync(Contact, Contact)

Chooses which of the raw contacts provides the main display picture for the aggregate.

public : IAsyncOperation<Platform::Boolean> TrySetPreferredSourceForPictureAsync(Contact aggregateContact, Contact rawContact)
public IAsyncOperation<bool> TrySetPreferredSourceForPictureAsync(Contact aggregateContact, Contact rawContact)
Public Function TrySetPreferredSourceForPictureAsync(aggregateContact As Contact, rawContact As Contact) As IAsyncOperation( Of bool )
Windows.ApplicationModel.Contacts.AggregateContactManager.trySetPreferredSourceForPictureAsync(aggregateContact, rawContact).done( /* Your success and error handlers */ );
Parameters
aggregateContact
Contact Contact Contact Contact

The aggregate contact on which to set the picture.

rawContact
Contact Contact Contact Contact

The raw contact that provides the picture for the aggregate.

Returns

True if successful, otherwise false.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
contactsSystem

UnlinkRawContactAsync(Contact) UnlinkRawContactAsync(Contact) UnlinkRawContactAsync(Contact) UnlinkRawContactAsync(Contact)

Asynchronously unlinks a raw contact from the parent aggregate contact.

public : IAsyncAction UnlinkRawContactAsync(Contact contact)
public IAsyncAction UnlinkRawContactAsync(Contact contact)
Public Function UnlinkRawContactAsync(contact As Contact) As IAsyncAction
Windows.ApplicationModel.Contacts.AggregateContactManager.unlinkRawContactAsync(contact).done( /* Your success and error handlers */ );
Parameters
contact
Contact Contact Contact Contact

The raw contact to remove from the aggregate.

Returns

An async action that indicates the operation is complete.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
contactsSystem