ContactList 클래스

정의

네임스페이스:

Windows.ApplicationModel.Contacts

Contact 개체의 목록을 나타냅니다.

public ref class ContactList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactList final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactList

Public NotInheritable Class ContactList

상속

Object Platform::Object IInspectable ContactList

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
앱 기능	contactsSystem

설명

ContactStore.CreateContactListAsync를 호출하여 이 클래스의 새 instance 만듭니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	RegisterSyncManagerAsync
1607	14393	SyncConstraints
1709	16299	GetChangeTracker
1709	16299	LimitedWriteOperations

속성

ChangeTracker	이 ContactList에 대한 앱의 ContactChangeTracker를 가져옵니다.
DisplayName	사용자 인터페이스에 표시하기에 적합한 ContactList의 이름을 가져오거나 설정합니다.
Id	이 ContactList에 대한 로컬 고유 식별자를 가져옵니다.
IsHidden	ContactList가 사용자 인터페이스에 숨겨져 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.
LimitedWriteOperations	앱이 만들지 않은 연락처 목록에서 수행할 수 있는 작업을 제공하는 개체를 가져옵니다.
OtherAppReadAccess	시스템의 다른 앱에 대해 이 ContactList 에 대한 읽기 액세스 수준을 나타내는 값을 가져오거나 설정합니다.
OtherAppWriteAccess	시스템의 다른 앱에 대해 이 ContactList 에 대한 쓰기 액세스 수준을 나타내는 값을 가져오거나 설정합니다.
SourceDisplayName	사용자 인터페이스에 표시하기에 적합한 ContactList 원본의 이름을 가져옵니다.
SupportsServerSearch	이 ContactList를 사용하여 원격 서버를 검색할 수 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.
SyncConstraints	동기화할 수 있는 연락처 목록 데이터의 최대 크기를 나타내는 ContactListSyncConstraints 를 가져옵니다.
SyncManager	서버와 통신하는 데 사용되는 ContactListSyncManager 를 가져옵니다.
UserDataAccountId	이 ContactList에 대한 사용자 데이터 계정의 ID를 나타내는 문자열을 가져옵니다.

메서드

DeleteAsync()	ContactStore의 모든 Contact 개체를 포함하여 이 ContactList를 비 동기적으로 삭제합니다.
DeleteContactAsync(Contact)	이 ContactList 및ContactStore에서 비동기적으로 및 개별 연락처를 삭제합니다.
GetChangeTracker(String)	ContactList에서 Contact 개체의 변경 내용을 모니터링하는 기능을 제공하는 ContactChangeTracker를 가져옵니다.
GetContactAsync(String)	ContactList에서 지정된 Contact 개체를 비동기적으로 검색합니다.
GetContactFromRemoteIdAsync(String)	지정된 RemoteId로 식별된 연락처를 비동기적으로 가져옵니다.
GetContactReader()	이 ContactList와 연결된 ContactReader 개체를 가져옵니다.
GetContactReader(ContactQueryOptions)	이 ContactList와 연결되고 지정된 ContactQueryOptions를 사용하여 ContactReader 개체를 가져옵니다.
GetMeContactAsync()	현재 사용자를 나타내는 Contact 개체를 비동기적으로 가져옵니다.
RegisterSyncManagerAsync()	SyncManager를 ContactList에 추가합니다.
SaveAsync()	이 ContactList를 비동기적으로 저장합니다.
SaveContactAsync(Contact)	지정한 연락처 를 ContactStore에 비동기적으로 저장합니다.

이벤트

ContactChanged

이 ContactList의 연락처가 변경되었을 때 발생합니다.