ContactManager ContactManager ContactManager ContactManager Class

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

Syntax

Declaration

public static class ContactManagerpublic static class ContactManagerPublic Static Class ContactManager

Remarks

All relevant methods of this class are static methods.

For info about how to manage contacts, see Managing contact cards and Managing contact cards .

Properties summary

Gets or puts the display name order.

Gets or puts the sort order.

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

Methods summary

Asynchronously converts a Contact to a vCard.

Asynchronously converts a Contact to a vCard.

Asynchronously converts a vCard to a Contact.

Gets the ContactManagerForUser object for the specified user.

Gets a Boolean value indicating if the ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect) method is supported on the current platform.

Gets a Boolean value indicating if the ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions) method is supported on the current platform.

Prerelease. Gets a Boolean value indicating if the ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.ApplicationModel.Contacts.FullContactCardOptions) method is supported on the current platform.

Asynchronously requests access to the ContactAnnotationStore.

Retrieves a ContactStore object that enables searching or retrieving contacts on the device.

Retrieves a ContactStore object that enables searching or retrieving contacts on the device.

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

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

Shows a contact card with the specified parameters.

Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.

Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.

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

Properties

  • SystemDisplayNameOrder
    SystemDisplayNameOrder
    SystemDisplayNameOrder
    SystemDisplayNameOrder

    Gets or puts the display name order.

    public static ContactNameOrder SystemDisplayNameOrder { get; set; }public static ContactNameOrder SystemDisplayNameOrder { get; set; }Public Static ReadWrite Property SystemDisplayNameOrder As ContactNameOrder

    Property Value

  • SystemSortOrder
    SystemSortOrder
    SystemSortOrder
    SystemSortOrder

    Gets or puts the sort order.

    public static ContactNameOrder SystemSortOrder { get; set; }public static ContactNameOrder SystemSortOrder { get; set; }Public Static ReadWrite Property SystemSortOrder As ContactNameOrder

    Property Value

  • IncludeMiddleNameInSystemDisplayAndSort
    IncludeMiddleNameInSystemDisplayAndSort
    IncludeMiddleNameInSystemDisplayAndSort
    IncludeMiddleNameInSystemDisplayAndSort

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

    public static bool IncludeMiddleNameInSystemDisplayAndSort { get; set; }public static bool IncludeMiddleNameInSystemDisplayAndSort { get; set; }Public Static ReadWrite Property IncludeMiddleNameInSystemDisplayAndSort As bool

    Property Value

    • bool
      bool
      bool
      bool

      A Boolean that indicates whether the middle name of a contact is included in the DisplayName and SortName of a contact.

Methods

  • ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact)
    ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact)
    ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact)
    ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact)

    Asynchronously converts a Contact to a vCard.

    public static IAsyncOperation<RandomAccessStreamReference> ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact contact)public static IAsyncOperation<RandomAccessStreamReference> ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact contact)Public Static Function ConvertContactToVCardAsync(contact As Windows.ApplicationModel.Contacts.Contact) As IAsyncOperation( Of RandomAccessStreamReference )

    Parameters

    Returns

    • A stream containing the vCard data.

  • ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact,System.UInt32)
    ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact,System.UInt32)
    ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact,System.UInt32)
    ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact,System.UInt32)

    Asynchronously converts a Contact to a vCard.

    public static IAsyncOperation<RandomAccessStreamReference> ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact contact,System.UInt32 maxBytes)public static IAsyncOperation<RandomAccessStreamReference> ConvertContactToVCardAsync(Windows.ApplicationModel.Contacts.Contact contact,System.UInt32 maxBytes)Public Static Function ConvertContactToVCardAsync(contact As Windows.ApplicationModel.Contacts.Contact,maxBytes As System.UInt32) As IAsyncOperation( Of RandomAccessStreamReference )

    Parameters

    Returns

    • A stream containing the vCard data.

  • ConvertVCardToContactAsync(Windows.Storage.Streams.IRandomAccessStreamReference)
    ConvertVCardToContactAsync(Windows.Storage.Streams.IRandomAccessStreamReference)
    ConvertVCardToContactAsync(Windows.Storage.Streams.IRandomAccessStreamReference)
    ConvertVCardToContactAsync(Windows.Storage.Streams.IRandomAccessStreamReference)

    Asynchronously converts a vCard to a Contact.

    public static IAsyncOperation<Contact> ConvertVCardToContactAsync(Windows.Storage.Streams.IRandomAccessStreamReference vCard)public static IAsyncOperation<Contact> ConvertVCardToContactAsync(Windows.Storage.Streams.IRandomAccessStreamReference vCard)Public Static Function ConvertVCardToContactAsync(vCard As Windows.Storage.Streams.IRandomAccessStreamReference) As IAsyncOperation( Of Contact )

    Parameters

    Returns

  • GetForUser(Windows.System.User)
    GetForUser(Windows.System.User)
    GetForUser(Windows.System.User)
    GetForUser(Windows.System.User)

    Gets the ContactManagerForUser object for the specified user.

    public static ContactManagerForUser GetForUser(Windows.System.User user)public static ContactManagerForUser GetForUser(Windows.System.User user)Public Static Function GetForUser(user As Windows.System.User) As ContactManagerForUser

    Parameters

    Returns

  • IsShowContactCardSupported()
    IsShowContactCardSupported()
    IsShowContactCardSupported()
    IsShowContactCardSupported()

    Gets a Boolean value indicating if the ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect) method is supported on the current platform.

    public static bool IsShowContactCardSupported()public static bool IsShowContactCardSupported()Public Static Function IsShowContactCardSupported() As bool

    Returns

  • IsShowDelayLoadedContactCardSupported()
    IsShowDelayLoadedContactCardSupported()
    IsShowDelayLoadedContactCardSupported()
    IsShowDelayLoadedContactCardSupported()

    Gets a Boolean value indicating if the ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions) method is supported on the current platform.

    public static bool IsShowDelayLoadedContactCardSupported()public static bool IsShowDelayLoadedContactCardSupported()Public Static Function IsShowDelayLoadedContactCardSupported() As bool

    Returns

  • IsShowFullContactCardSupportedAsync()
    IsShowFullContactCardSupportedAsync()
    IsShowFullContactCardSupportedAsync()
    IsShowFullContactCardSupportedAsync()

    Prerelease. Gets a Boolean value indicating if the ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.ApplicationModel.Contacts.FullContactCardOptions) method is supported on the current platform.

    public static IAsyncOperation<bool> IsShowFullContactCardSupportedAsync()public static IAsyncOperation<bool> IsShowFullContactCardSupportedAsync()Public Static Function IsShowFullContactCardSupportedAsync() As IAsyncOperation( Of bool )

    Returns

  • RequestAnnotationStoreAsync(Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType)
    RequestAnnotationStoreAsync(Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType)
    RequestAnnotationStoreAsync(Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType)
    RequestAnnotationStoreAsync(Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType)

    Asynchronously requests access to the ContactAnnotationStore.

    public static IAsyncOperation<ContactAnnotationStore> RequestAnnotationStoreAsync(Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType accessType)public static IAsyncOperation<ContactAnnotationStore> RequestAnnotationStoreAsync(Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType accessType)Public Static Function RequestAnnotationStoreAsync(accessType As Windows.ApplicationModel.Contacts.ContactAnnotationStoreAccessType) As IAsyncOperation( Of ContactAnnotationStore )

    Parameters

    Returns

  • RequestStoreAsync()
    RequestStoreAsync()
    RequestStoreAsync()
    RequestStoreAsync()

    Retrieves a ContactStore object that enables searching or retrieving contacts on the device.

    public static IAsyncOperation<ContactStore> RequestStoreAsync()public static IAsyncOperation<ContactStore> RequestStoreAsync()Public Static Function RequestStoreAsync() As IAsyncOperation( Of ContactStore )

    Returns

    • An asynchronous operation that returns a ContactStore object on successful completion.

    Remarks

    This method requests ContactStoreAccessType access to the contact store. If you require a different level of access, call the RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType) method instead.

  • RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType)
    RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType)
    RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType)
    RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType)

    Retrieves a ContactStore object that enables searching or retrieving contacts on the device.

    public static IAsyncOperation<ContactStore> RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType accessType)public static IAsyncOperation<ContactStore> RequestStoreAsync(Windows.ApplicationModel.Contacts.ContactStoreAccessType accessType)Public Static Function RequestStoreAsync(accessType As Windows.ApplicationModel.Contacts.ContactStoreAccessType) As IAsyncOperation( Of ContactStore )

    Parameters

    Returns

    • An asynchronous operation that returns a ContactStore object on successful completion.

  • ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect)

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

    public static void ShowContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection)public static void ShowContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection)Public Static Function ShowContactCard(contact As Windows.ApplicationModel.Contacts.Contact,selection As Windows.Foundation.Rect) As void

    Parameters

    • contact

      The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.

      If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.

    • selection

      The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.

    Remarks

    Note

    Source apps must be running in the foreground to call this method. An app that runs in the background will get an "Access Denied" exception if it calls this method.

    Most typical operations will result in displaying a UI.

    • If there is one exact match for the requested contact: Shows the contact card UI with information from the contacts store in the operating system.
    • If there are multiple matches: Shows the contact card UI for the first matching contact found.
    • If there is no match: Shows the contact card UI, where the contact info comes from the input contact object.

    If there's an error, such as an invalid input for the contact parameter, no UI is displayed.

    For querying purposes, phone numbers support characters 0-9 and a-z/A-Z. If you put any other characters in a phone number, they are ignored when you query the contact.

    For info about how to manage contacts, see Managing contact cards and Managing contact cards .

    For querying purposes, phone numbers support characters 0-9 and a-z/A-Z. If you put any other characters in a phone number, they are ignored when you query the contact.

  • ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)

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

    public static void ShowContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement)public static void ShowContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement)Public Static Function ShowContactCard(contact As Windows.ApplicationModel.Contacts.Contact,selection As Windows.Foundation.Rect,preferredPlacement As Windows.UI.Popups.Placement) As void

    Parameters

    • contact

      The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.

      If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.

    • selection

      The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.

    • preferredPlacement

      The Placement that describes the preferred placement of the contact card.

    Remarks

    See the remarks section of this overload: ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect).

  • ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)
    ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)

    Shows a contact card with the specified parameters.

    public static void ShowContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement,Windows.ApplicationModel.Contacts.ContactCardOptions contactCardOptions)public static void ShowContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement,Windows.ApplicationModel.Contacts.ContactCardOptions contactCardOptions)Public Static Function ShowContactCard(contact As Windows.ApplicationModel.Contacts.Contact,selection As Windows.Foundation.Rect,preferredPlacement As Windows.UI.Popups.Placement,contactCardOptions As Windows.ApplicationModel.Contacts.ContactCardOptions) As void

    Parameters

    • contact

      The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.

      If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.

    • selection

      The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.

    • preferredPlacement

      The Placement that describes the preferred placement of the contact card.

    • contactCardOptions

      Specifies how to display the contact card, such as which tab to start on when displaying a mini contact card.

    Remarks

    See the remarks section of this overload: ShowContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect).

  • ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)
    ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)
    ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)
    ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement)

    Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.

    public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement)public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement)Public Static Function ShowDelayLoadedContactCard(contact As Windows.ApplicationModel.Contacts.Contact,selection As Windows.Foundation.Rect,preferredPlacement As Windows.UI.Popups.Placement) As ContactCardDelayedDataLoader

    Parameters

    • contact

      The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.

      If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.

    • selection

      The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.

    • preferredPlacement

      The Placement that describes the preferred placement of the contact card.

    Returns

  • ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)
    ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)
    ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)
    ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.Foundation.Rect,Windows.UI.Popups.Placement,Windows.ApplicationModel.Contacts.ContactCardOptions)

    Shows a contact card that can be updated later if the contact does not exist in the user’s contact database.

    public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement,Windows.ApplicationModel.Contacts.ContactCardOptions contactCardOptions)public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.Foundation.Rect selection,Windows.UI.Popups.Placement preferredPlacement,Windows.ApplicationModel.Contacts.ContactCardOptions contactCardOptions)Public Static Function ShowDelayLoadedContactCard(contact As Windows.ApplicationModel.Contacts.Contact,selection As Windows.Foundation.Rect,preferredPlacement As Windows.UI.Popups.Placement,contactCardOptions As Windows.ApplicationModel.Contacts.ContactCardOptions) As ContactCardDelayedDataLoader

    Parameters

    • contact

      The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.

      If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.

    • selection

      The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the contact card, not within that rectangular area. For example, if an app uses a button to show the contact card, pass the Rect of the button so the contact card displays around the button, not overlapping it.

    • preferredPlacement

      The Placement that describes the preferred placement of the contact card.

    • contactCardOptions

      Specifies how to display the contact card, such as which tab to start on if you are displaying a mini contact card, or what header type to use if you are showing a full contact card.

    Returns

  • ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.ApplicationModel.Contacts.FullContactCardOptions)
    ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.ApplicationModel.Contacts.FullContactCardOptions)
    ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.ApplicationModel.Contacts.FullContactCardOptions)
    ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact,Windows.ApplicationModel.Contacts.FullContactCardOptions)

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

    public static void ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.ApplicationModel.Contacts.FullContactCardOptions fullContactCardOptions)public static void ShowFullContactCard(Windows.ApplicationModel.Contacts.Contact contact,Windows.ApplicationModel.Contacts.FullContactCardOptions fullContactCardOptions)Public Static Function ShowFullContactCard(contact As Windows.ApplicationModel.Contacts.Contact,fullContactCardOptions As Windows.ApplicationModel.Contacts.FullContactCardOptions) As void

    Parameters

    • contact

      The object that represents the contact that the app wants to display the contact card for.contact must contain at least an Id, Emails, or a phone number from a Phones list to query the user’s contact database to retrieve a matching contact to display. Id has higher priority for querying. If an Id matches, the rest of query parameters will be ignored for matching purposes. If an Id does not find a match, the query uses the rest of query parameters. Emails and Phones have equal priority for matching. If multiple email addresses, or phone numbers, or both are provided, the query first performs an exact match, requiring all query parameters to match a system contact record. If this results in no matches, the query uses "best effort" match, in which a match of any query parameters is sufficient.

      If no matches occur, the data in the input contact displays in the contact card. If a match occurs, only system contact data displays, and the data in the input contact is discarded.

    • fullContactCardOptions

      Specifies how to display the full contact card.

Attributes

Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.StaticAttribute

Details

Assembly

Windows.ApplicationModel.Contacts.dll