通过

ContactAnnotationStore.GetAnnotationListAsync(String) 方法

  • 参考

定义

命名空间:
Windows.ApplicationModel.Contacts
编辑

异步获取具有指定 ID 的 ContactAnnotationList 。

public:
 virtual IAsyncOperation<ContactAnnotationList ^> ^ GetAnnotationListAsync(Platform::String ^ annotationListId) = GetAnnotationListAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<ContactAnnotationList> GetAnnotationListAsync(winrt::hstring const& annotationListId);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<ContactAnnotationList> GetAnnotationListAsync(string annotationListId);
function getAnnotationListAsync(annotationListId)
Public Function GetAnnotationListAsync (annotationListId As String) As IAsyncOperation(Of ContactAnnotationList)

参数

annotationListId
String

Platform::String

winrt::hstring

要获取的 ContactAnnotationList 的 ID。

返回

IAsyncOperation<ContactAnnotationList>

具有 annotationListId 中指定的 ID 的 ContactAnnotationList。

属性
RemoteAsyncAttribute

Windows 要求

应用功能
contactsSystem

示例

以下示例提供了用于创建批注列表、删除特定批注列表和删除存储区中所有批注列表的可重用方法。

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;
}

适用于

另请参阅