StorageLibraryChangeTrackerOptions クラス

リファレンス

定義

名前空間:: Windows.Storage

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

呼び出し元が変更トラッカーで EnableWithOptions を呼び出して、最後の変更 ID や最後の変更 ID のみを含むすべての変更を追跡することを選択できるようにします。

public ref class StorageLibraryChangeTrackerOptions sealed

/// [Windows.Foundation.Metadata.Activatable(720896, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 720896)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StorageLibraryChangeTrackerOptions final

[Windows.Foundation.Metadata.Activatable(720896, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 720896)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StorageLibraryChangeTrackerOptions

function StorageLibraryChangeTrackerOptions()

Public NotInheritable Class StorageLibraryChangeTrackerOptions

継承: Object Platform::Object IInspectable StorageLibraryChangeTrackerOptions

属性: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10, version 2104 (10.0.20348.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v12.0 で導入)

例

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

注釈

既定では、特定のライブラリまたはフォルダーで変更トラッカーを有効にすると、すべての変更の詳細が追跡され、最後の変更 ID も追跡されます。StorageLibraryChangeTrackerOptions::TrackChangeDetails を false に設定し、次の例のように EnableWithOptions を使用すると、システムは、使用するシステムストレージが少ない最後の変更 ID のみを追跡します。

アプリケーションで変更に関する詳細が必要ない場合は、これが推奨される方法です。

コンストラクター

StorageLibraryChangeTrackerOptions()

StorageFolder または StorageLibrary の変更トラッカーの動作を設定するために使用する StorageLibraryChangeTrackerOptions のコンストラクター。

プロパティ

TrackChangeDetails

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

適用対象

こちらもご覧ください

TrackChangeDetails