ContactAnnotationStore.CreateAnnotationListAsync 메서드

정의

네임스페이스:

Windows.ApplicationModel.Contacts

오버로드

CreateAnnotationListAsync()	ContactAnnotationList를 비동기적으로 만듭니다.
CreateAnnotationListAsync(String)	ContactAnnotationList를 비동기적으로 만들고 지정된 사용자 데이터 계정 ID와 연결합니다.

CreateAnnotationListAsync()

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)

반환

IAsyncOperation<ContactAnnotationList>

새로 만든 ContactAnnotationList입니다.

특성

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

추가 정보

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

CreateAnnotationListAsync(String)

ContactAnnotationList를 비동기적으로 만들고 지정된 사용자 데이터 계정 ID와 연결합니다.

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)

매개 변수

userDataAccountId

String

Platform::String

winrt::hstring

새 ContactAnnotationList를 연결할 사용자 데이터 계정의 ID입니다. 사용자 데이터 계정은 이 앱에서 소유해야 합니다.

반환

IAsyncOperation<ContactAnnotationList>

새로 만든 ContactAnnotationList입니다.

특성

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

설명

userDataAccountId에 지정된 사용자 데이터 계정은 이 앱을 소유해야 합니다.

추가 정보

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