StorageLibraryChangeTrackerOptions Classe

Definição

Namespace:

Windows.Storage

Permite que os chamadores chamem EnableWithOptions no rastreador de alterações para optar por controlar todas as alterações, incluindo a última ID de alteração ou apenas a última ID de alteração.

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

Herança

Object Platform::Object IInspectable StorageLibraryChangeTrackerOptions

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 2104 (introduzida na 10.0.20348.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v12.0)

Exemplos

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

Comentários

Por padrão, habilitar um rastreador de alterações em uma biblioteca ou pasta específica acompanhará todos os detalhes da alteração, bem como acompanhará a última ID de alteração. Definindo StorageLibraryChangeTrackerOptions::TrackChangeDetails como false e usando EnableWithOptions como o exemplo abaixo, o sistema só manterá o controle da última ID de alteração que usa menos armazenamento do sistema.

Se o aplicativo não precisar de detalhes sobre as alterações, essa será a abordagem recomendada.

Construtores

StorageLibraryChangeTrackerOptions()

Construtor para StorageLibraryChangeTrackerOptions a ser usado para configurar o comportamento do rastreador de alterações para um StorageFolder ou StorageLibrary.

Propriedades

TrackChangeDetails

Usado para determinar se o sistema controlará cada alteração individual ou apenas a última ID de alteração para um determinado rastreador de alterações.

Confira também

• TrackChangeDetails