ContactAnnotationStore.CreateAnnotationListAsync Méthode

Définition

Espace de noms:

Windows.ApplicationModel.Contacts

Surcharges

CreateAnnotationListAsync()	Crée de manière asynchrone un ContactAnnotationList.
CreateAnnotationListAsync(String)	Crée de manière asynchrone un ContactAnnotationList et l’associe à l’ID de compte de données utilisateur spécifié.

CreateAnnotationListAsync()

Crée de manière asynchrone un ContactAnnotationList.

public:
 virtual IAsyncOperation<ContactAnnotationList ^> ^ CreateAnnotationListAsync() = CreateAnnotationListAsync;

/// [Windows.Foundation.Metadata.Overload("CreateAnnotationListAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<ContactAnnotationList> CreateAnnotationListAsync();

[Windows.Foundation.Metadata.Overload("CreateAnnotationListAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<ContactAnnotationList> CreateAnnotationListAsync();

function createAnnotationListAsync()

Public Function CreateAnnotationListAsync () As IAsyncOperation(Of ContactAnnotationList)

Retours

IAsyncOperation<ContactAnnotationList>

ContactAnnotationList nouvellement créé.

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

contactsSystem

Exemples

L’exemple suivant fournit des méthodes réutilisables pour créer une liste d’annotations, supprimer une liste d’annotations spécifique et supprimer toutes les listes d’annotations dans un magasin.

public async Task<ContactAnnotationList> CreateAnnotationList()
{
    // Get the data store.
    ContactAnnotationStore store = await ContactManager.RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType.AppAnnotationsReadWrite);

    // Create a new list.
    ContactAnnotationList list = await store.CreateAnnotationListAsync();

    // Find the list to verify it was created.
    IReadOnlyList<ContactAnnotationList> lists = await store.FindAnnotationListsAsync();

    for (int i = 0; i < lists.Count; i++)
    {
        // Do the IDs match?
        if (list.Id == lists[i].Id)
        {
            // Found it! Return the new list.
            return(list);
        }
    }

    // List not created, return null.
    return(null);
}

public async Task<Boolean> DeleteAnnotationList(string listId)
{
    // Get the store.
    ContactAnnotationStore store = await ContactManager.RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType.AppAnnotationsReadWrite);

    // Find the list.
    ContactAnnotationList list = await store.GetAnnotationListAsync(listId);

    // Make sure we got it.
    if (list.Id == listId)
    {
        // Delete the list.
        await list.DeleteAsync();
        return true;
    }

    return false;
}

public async Task<Boolean> DeleteAllAnnotationLists()
{
    // Get the store.
    ContactAnnotationStore store = await ContactManager.RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType.AppAnnotationsReadWrite);

    IReadOnlyList<ContactAnnotationList> lists = await store.FindAnnotationListsAsync();

    // Make sure at least one annotation list exists.
    if (lists.Count > 0)
    {
        // Find the list.
        for (int i = 0; i < lists.Count; i++)
        {
            await lists[i].DeleteAsync();
        }

        return true;
    }

    return false;
}

Voir aussi

• RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType)
• ContactAnnotationList
• CreateAnnotationListAsync(String)
• GetAnnotationListAsync(String)
• FindAnnotationListsAsync()
• DeleteAsync()

CreateAnnotationListAsync(String)

Crée de manière asynchrone un ContactAnnotationList et l’associe à l’ID de compte de données utilisateur spécifié.

public:
 virtual IAsyncOperation<ContactAnnotationList ^> ^ CreateAnnotationListAsync(Platform::String ^ userDataAccountId) = CreateAnnotationListAsync;

/// [Windows.Foundation.Metadata.Overload("CreateAnnotationListInAccountAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<ContactAnnotationList> CreateAnnotationListAsync(winrt::hstring const& userDataAccountId);

[Windows.Foundation.Metadata.Overload("CreateAnnotationListInAccountAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<ContactAnnotationList> CreateAnnotationListAsync(string userDataAccountId);

function createAnnotationListAsync(userDataAccountId)

Public Function CreateAnnotationListAsync (userDataAccountId As String) As IAsyncOperation(Of ContactAnnotationList)

Paramètres

userDataAccountId

String

Platform::String

winrt::hstring

ID du compte de données utilisateur auquel associer le nouveau ContactAnnotationList. Le compte de données utilisateur doit appartenir à cette application.

Retours

IAsyncOperation<ContactAnnotationList>

ContactAnnotationList nouvellement créé.

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

contactsSystem

Exemples

L’exemple suivant fournit des méthodes réutilisables pour créer une liste d’annotations, supprimer une liste d’annotations spécifique et supprimer toutes les listes d’annotations dans un magasin.

public async Task<ContactAnnotationList> CreateAnnotationList()
{
    // Get the data store.
    ContactAnnotationStore store = await ContactManager.RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType.AppAnnotationsReadWrite);

    // Create a new list.
    ContactAnnotationList list = await store.CreateAnnotationListAsync();

    // Find the list to verify it was created.
    IReadOnlyList<ContactAnnotationList> lists = await store.FindAnnotationListsAsync();

    for (int i = 0; i < lists.Count; i++)
    {
        // Do the IDs match?
        if (list.Id == lists[i].Id)
        {
            // Found it! Return the new list.
            return(list);
        }
    }

    // List not created, return null.
    return(null);
}

public async Task<Boolean> DeleteAnnotationList(string listId)
{
    // Get the store.
    ContactAnnotationStore store = await ContactManager.RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType.AppAnnotationsReadWrite);

    // Find the list.
    ContactAnnotationList list = await store.GetAnnotationListAsync(listId);

    // Make sure we got it.
    if (list.Id == listId)
    {
        // Delete the list.
        await list.DeleteAsync();
        return true;
    }

    return false;
}

public async Task<Boolean> DeleteAllAnnotationLists()
{
    // Get the store.
    ContactAnnotationStore store = await ContactManager.RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType.AppAnnotationsReadWrite);

    IReadOnlyList<ContactAnnotationList> lists = await store.FindAnnotationListsAsync();

    // Make sure at least one annotation list exists.
    if (lists.Count > 0)
    {
        // Find the list.
        for (int i = 0; i < lists.Count; i++)
        {
            await lists[i].DeleteAsync();
        }

        return true;
    }

    return false;
}

Remarques

Le compte de données utilisateur spécifié dans userDataAccountId doit appartenir à cette application.

Voir aussi

• RequestAnnotationStoreAsync(ContactAnnotationStoreAccessType)
• ContactAnnotationList
• CreateAnnotationListAsync()
• GetAnnotationListAsync(String)
• FindAnnotationListsAsync()
• DeleteAsync()