StorageLibraryChangeTrackerOptions.TrackChangeDetails プロパティ

定義

システムが個々の変更を追跡するか、特定の変更トラッカーの最後の変更 ID のみを追跡するかを判断するために使用されます。

public:
 property bool TrackChangeDetails { bool get(); void set(bool value); };
bool TrackChangeDetails();

void TrackChangeDetails(bool value);
public bool TrackChangeDetails { get; set; }
var boolean = storageLibraryChangeTrackerOptions.trackChangeDetails;
storageLibraryChangeTrackerOptions.trackChangeDetails = boolean;
Public Property TrackChangeDetails As Boolean

プロパティ値

Boolean

bool

変更トラッカーがすべての変更の詳細を追跡するか、最後の変更 ID のみを追跡するかを決定するブール値。設定または変更されていない場合、既定値は true になります。

// applications are expected to persist the previous value
UINT64 appsLastPersistedChangeId = StorageLibraryLastChangeId::Unknown();
StorageFolder folder = StorageFolder::GetFolderFromPathAsync(L"my folder path").get();

StorageLibraryChangeTracker tracker = folder.TryGetChangeTracker();
if (tracker != nullptr)
{
StorageLibraryChangeTrackerOptions ops;
ops.TrackChangeDetails(false);
tracker.Enable(ops);

StorageLibraryChangeReader reader = tracker.GetChangeReader();
if (reader != nullptr)
{
    UINT32 changeId = reader.GetLastChangeId();
    if ((changeId == StorageLibraryLastChangeId::Unknown())
    {
        ScanFolderSlow();
    }
    else if (changeId == 0)
    {
        // no changes in the storage folder yet, OR nothing has changed
        ProcessNormalApplicationStartup();
    }
    else if (changeId != appsLastPersistedChangeId)
    {
        // There have been new changes since we’ve last ran, process them
        appsLastPersistedChangeId = changeId;
        ScanFolderForChanges();
    }
    else
    {
        // changeId and our last persisted change id match, also normal application startup
        ProcessNormalApplicationStartup();
    }
}
}

注釈

TrackChangeDetails は、すべての変更トラッカーに対して既定で true です。 この値を false に設定すると、StorageLibraryChangeTracker::EnableWithOptions に渡すと、アプリケーションが最後の変更 ID のみを懸念し、個々の変更に関する詳細ではなく、システム ストレージに保存できます。

適用対象

こちらもご覧ください