AppointmentStore.GetChangeTracker(String) Methode

Definition

Namespace:

Windows.ApplicationModel.Appointments

Ruft einen AppointmentStoreChangeTracker ab, der Funktionen zum Überwachen von Änderungen an Appointment-Objekten im AppointmentStore bereitstellt.

public:
 virtual AppointmentStoreChangeTracker ^ GetChangeTracker(Platform::String ^ identity) = GetChangeTracker;

AppointmentStoreChangeTracker GetChangeTracker(winrt::hstring const& identity);

public AppointmentStoreChangeTracker GetChangeTracker(string identity);

function getChangeTracker(identity)

Public Function GetChangeTracker (identity As String) As AppointmentStoreChangeTracker

Parameter

identity

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die den AppointmentStoreChangeTracker instance im Speicher identifiziert.

Gibt zurück

AppointmentStoreChangeTracker

Ein AppointmentStoreChangeTracker , der Funktionen zum Überwachen von Änderungen an Appointment-Objekten im AppointmentStore bereitstellt.

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)
App-Funktionen	appointmentsSystem

Beispiele

In diesem Beispiel wird eine benannte Änderungsnachverfolgung verwendet, um die Dashboard einer Anwendung mit Termininformationen zu aktualisieren.

private async Task UpdateDashboard(AppointmentStore store)
{
    AppointmentStoreChangeTracker tracker = store.GetChangeTracker("DashboardUpdater");

    // Check to see if we were already tracking. If not then we don't know
    // what changed and we should update everything.
    if (!tracker.IsTracking)
    {
        tracker.Enable();
        UpdateFullDashboard();

        // Don't return yet. We still want to process any changes which
        // happened while we were updating the dashboard.
    }

    // check for changes
    IReadOnlyList<AppointmentStoreChange> changes;
    do
    {
        changes = await tracker.GetChangeReader().ReadBatchAsync();
        foreach (AppointmentStoreChange change in changes)
        {
            UpdateDashboardWidget(change);
        }
    } while (changes.Count > 0);
}

Hinweise

Mit dieser Methode können Sie mehrere AppointmentStoreChangeTracker-Instanzen erstellen. Wenn Sie eine Zeichenfolge übergeben, die einen AppointmentStoreChangeTracker identifiziert, der bereits im Speicher vorhanden ist, gibt diese Methode diesen instance zurück. Wenn die an diese Methode übergebene Zeichenfolge keinen vorhandenen AppointmentStoreChangeTracker identifiziert, gibt diese Methode einen neuen AppointmentStoreChangeTracker zurück.

Sie können die IsTracking-Eigenschaft des AppointmentStoreChangeTracker verwenden, um zu bestimmen, ob die Änderungsnachverfolgung für den AppointmentStoreChangeTracker aktiviert ist.