ContactList Klasse

Definition

Namespace:

Windows.ApplicationModel.Contacts

Stellt eine Liste von Contact-Objekten dar.

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

Vererbung

Object Platform::Object IInspectable ContactList

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	contactsSystem

Hinweise

Rufen Sie ContactStore.CreateContactListAsync auf, um eine neue instance dieser Klasse zu erstellen.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	RegisterSyncManagerAsync
1607	14393	SyncConstraints
1709	16299	GetChangeTracker
1709	16299	LimitedWriteOperations

Eigenschaften

ChangeTracker	Ruft den ContactChangeTracker der App für diese ContactList ab.
DisplayName	Ruft den Namen der ContactList ab, der für die Anzeige auf der Benutzeroberfläche geeignet ist, oder legt den Namen fest.
Id	Ruft den lokal eindeutigen Bezeichner für diese ContactList ab.
IsHidden	Ruft einen booleschen Wert ab, der angibt, ob die ContactList in der Benutzeroberfläche ausgeblendet ist, oder legt diesen fest.
LimitedWriteOperations	Ruft ein -Objekt ab, das Vorgänge bereitstellt, die eine App für eine Kontaktliste ausführen kann, die sie nicht erstellt hat.
OtherAppReadAccess	Ruft einen Wert ab, der die Lesezugriffsebene für diese ContactList für andere Apps im System angibt, oder legt diesen fest.
OtherAppWriteAccess	Ruft einen Wert ab, der die Schreibzugriffsebene für diese ContactList für andere Apps im System angibt, oder legt diesen fest.
SourceDisplayName	Ruft den Namen der Quelle der ContactList ab, die für die Anzeige in der Benutzeroberfläche geeignet ist.
SupportsServerSearch	Ruft einen booleschen Wert ab, der angibt, ob Sie den Remoteserver mit dieser ContactList durchsuchen können, oder legt diesen fest.
SyncConstraints	Ruft die ContactListSyncConstraints ab, die die maximale Anzahl von Kontaktlistendaten angibt, die synchronisiert werden können.
SyncManager	Ruft den ContactListSyncManager ab, der für die Kommunikation mit dem Server verwendet wird.
UserDataAccountId	Ruft eine Zeichenfolge ab, die die ID des Benutzerkontos für diese ContactList darstellt.

Methoden

DeleteAsync()	Löscht diese ContactList asynchron, einschließlich aller Contact-Objekte im ContactStore.
DeleteContactAsync(Contact)	Löscht asynchron und einzelne Kontakte aus dieser ContactList und dem ContactStore.
GetChangeTracker(String)	Ruft einen ContactChangeTracker ab, der Funktionen zum Überwachen von Änderungen an Contact-Objekten in der ContactList bereitstellt.
GetContactAsync(String)	Ruft das angegebene Contact-Objekt asynchron aus der ContactList ab.
GetContactFromRemoteIdAsync(String)	Ruft asynchron den Kontakt ab, der durch die angegebene RemoteId identifiziert wird.
GetContactReader()	Ruft ein ContactReader-Objekt ab, das dieser ContactList zugeordnet ist.
GetContactReader(ContactQueryOptions)	Ruft ein ContactReader-Objekt ab, das dieser ContactList zugeordnet ist und die angegebenen ContactQueryOptions verwendet.
GetMeContactAsync()	Ruft asynchron das Contact-Objekt ab, das den aktuellen Benutzer darstellt.
RegisterSyncManagerAsync()	Fügt der ContactList einen SyncManager hinzu.
SaveAsync()	Speichert diese ContactList asynchron.
SaveContactAsync(Contact)	Speichert den angegebenen Kontakt asynchron im ContactStore.

Ereignisse

ContactChanged

Tritt auf, wenn ein Kontakt in dieser ContactList geändert wurde.