AppointmentStore.GetChangeTracker(String) メソッド

定義

名前空間:

Windows.ApplicationModel.Appointments

AppointmentStore 内の Appointment オブジェクトに対する変更を監視する機能を提供する AppointmentStoreChangeTrackerを取得します。

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

パラメーター

identity

String

Platform::String

winrt::hstring

ストア内の AppointmentStoreChangeTracker インスタンスを識別する文字列。

戻り値

AppointmentStoreChangeTracker

AppointmentStore 内の Appointment オブジェクトに対する変更を監視する機能を提供する AppointmentStoreChangeTracker。

Windows の要件

デバイス ファミリ	Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v5.0 で導入)
アプリの機能	appointmentsSystem

例

この例では、名前付き変更トラッカーを使用して、アプリケーションのダッシュボードを予定情報で更新します。

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

注釈

このメソッドを使用して、複数の AppointmentStoreChangeTracker インスタンスを作成できます。 ストアに既に存在する AppointmentStoreChangeTracker を識別する文字列を渡すと、このメソッドはそのインスタンスを返します。 このメソッドに渡す文字列が既存の AppointmentStoreChangeTracker を識別しない場合、このメソッドは新しい AppointmentStoreChangeTracker を返します。

AppointmentStoreChangeTracker の IsTracking プロパティを使用して、AppointmentStoreChangeTracker に対して変更追跡が有効になっているかどうかを判断できます。