Freigeben über


ContactList Klasse

Definition

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

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.

Gilt für: