다음을 통해 공유


ContactList 클래스

정의

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
특성

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()

SyncManagerContactList에 추가합니다.

SaveAsync()

ContactList를 비동기적으로 저장합니다.

SaveContactAsync(Contact)

지정한 연락처ContactStore에 비동기적으로 저장합니다.

이벤트

ContactChanged

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

적용 대상