AppointmentStore.GetChangeTracker(String) Método

Definição

Namespace:

Windows.ApplicationModel.Appointments

Obtém um AppointmentStoreChangeTracker que fornece funcionalidade para monitorar alterações em objetos Appointment no AppointmentStore.

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

Parâmetros

identity

String

Platform::String

winrt::hstring

Uma cadeia de caracteres que identifica a instância AppointmentStoreChangeTracker no repositório.

Retornos

AppointmentStoreChangeTracker

Um AppointmentStoreChangeTracker que fornece funcionalidade para monitorar alterações em objetos Appointment no AppointmentStore.

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)
Funcionalidades do aplicativo	appointmentsSystem

Exemplos

Este exemplo usa um rastreador de alterações nomeado para atualizar o dashboard de um aplicativo com informações de compromisso.

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);
}

Comentários

Você pode criar várias instâncias appointmentStoreChangeTracker usando esse método. Se você passar uma cadeia de caracteres que identifica um AppointmentStoreChangeTracker que já existe no repositório, esse método retornará essa instância. Se a cadeia de caracteres passada para esse método não identificar um AppointmentStoreChangeTracker existente, esse método retornará um novo AppointmentStoreChangeTracker.

Você pode usar a propriedade IsTracking do AppointmentStoreChangeTracker para determinar se o controle de alterações está habilitado para AppointmentStoreChangeTracker.