StorageLibraryChangeTracker.Enable Método

Definição

Namespace:

Windows.Storage

Sobrecargas

Enable()	Habilita o controle de alterações para a biblioteca de armazenamento.
Enable(StorageLibraryChangeTrackerOptions)	Habilita o controle de alterações para a biblioteca de armazenamento em todas ou as alterações mais recentes com base na ID de alteração.

Enable()

Habilita o controle de alterações para a biblioteca de armazenamento.

public:
 virtual void Enable() = Enable;

void Enable();

public void Enable();

function enable()

Public Sub Enable ()

Enable(StorageLibraryChangeTrackerOptions)

Habilita o controle de alterações para a biblioteca de armazenamento em todas ou as alterações mais recentes com base na ID de alteração.

public:
 virtual void Enable(StorageLibraryChangeTrackerOptions ^ options) = Enable;

/// [Windows.Foundation.Metadata.Overload("EnableWithOptions")]
void Enable(StorageLibraryChangeTrackerOptions const& options);

[Windows.Foundation.Metadata.Overload("EnableWithOptions")]
public void Enable(StorageLibraryChangeTrackerOptions options);

function enable(options)

Public Sub Enable (options As StorageLibraryChangeTrackerOptions)

Parâmetros

options

StorageLibraryChangeTrackerOptions

Uma instância storageLibraryChangeTrackerOptions .

Atributos

OverloadAttribute

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

Para aplicativos interessados apenas na última ID de alteração, o sistema não armazenará todos os registros de alteração e o armazenamento em bloat no dispositivo. Nesse caso, ReadBatchAsync sempre retornará 0 registros.

Confira também

• StorageLibraryChangeTrackerOptions