CachedFileManager Classe

Definição

Namespace:

Windows.Storage

Permite que os aplicativos gerenciem atualizações em tempo real para arquivos.

public ref class CachedFileManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CachedFileManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CachedFileManager

Public Class CachedFileManager

Herança

Object Platform::Object IInspectable CachedFileManager

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo do seletor de arquivos mostra como usar um CachedFileManager para adiar atualizações para um arquivo até que o aplicativo termine de modificar o arquivo.

if (file != null)
{
    // Prevent updates to the remote version of the file until we finish making changes and call CompleteUpdatesAsync.
    CachedFileManager.DeferUpdates(file);

    // Write to file
    await FileIO.AppendTextAsync(file, "Swift as a shadow");
    // Let Windows know that we're finished changing the file so the server app can update the remote version of the file.

    // Complete updates. (May require Windows to ask for user input.)
    FileUpdateStatus status = await CachedFileManager.CompleteUpdatesAsync(file);
    switch (status)
    {
        case FileUpdateStatus.Complete:
            // Perform additional tasks like notifying user of status
            break;

        case FileUpdateStatus.CompleteAndRenamed:
            // Perform additional tasks like notifying user of status, or storing the renamed file for future use
            break;

        default:
            // Perform additional tasks like notifying user of status
            break;
    }
}

No exemplo, file é uma variável local que contém um StorageFile que representa o arquivo para o qual adiar as atualizações.

Comentários

Essa classe é estática e não pode ser instanciada. Em vez disso, chame os métodos diretamente.

Normalmente, o Windows inicia implicitamente atualizações para arquivos fornecidos por outros aplicativos quando esses arquivos são alterados.  No entanto, você pode controlar quando as atualizações são iniciadas chamando DeferUpdates. Se você usar esse método, será adiado até chamar CompleteUpdatesAsync para iniciá-los.

Métodos

CompleteUpdatesAsync(IStorageFile)	Inicia atualizações para o arquivo especificado. Esse método entra em contato com o aplicativo que forneceu o arquivo para executar as atualizações.
DeferUpdates(IStorageFile)	Permite que os aplicativos adiem atualizações em tempo real para um arquivo especificado.

Confira também

• Exemplo do seletor de arquivos (Windows 10)