CachedFileManager Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage
Modifica

Consente alle app di gestire gli aggiornamenti in tempo reale ai file.

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
Ereditarietà
Object Platform::Object IInspectable CachedFileManager
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di selezione file illustra come usare cachedFileManager per rinviare gli aggiornamenti a un file fino al termine della modifica del file.

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;
    }
}

Nell'esempio è file una variabile locale che contiene un File di archiviazione che rappresenta il file per rinviare gli aggiornamenti.

Commenti

Questa classe è statica e non può essere creata un'istanza. Chiamare i metodi direttamente.

In genere, Windows avvia in modo implicito gli aggiornamenti per i file forniti da altre app quando questi file cambiano.  Tuttavia, è possibile controllare quando gli aggiornamenti vengono avviati chiamando DeferUpdates. Se si usa questo metodo viene posticipato fino a quando non si chiama CompleteUpdatesAsync per avviarli.

Metodi

CompleteUpdatesAsync(IStorageFile)

Avvia gli aggiornamenti per il file specificato. Questo metodo contatta l'app che ha fornito il file per eseguire gli aggiornamenti.
DeferUpdates(IStorageFile)

Consente alle app di rinviare gli aggiornamenti in tempo reale per un file specificato.

Si applica a

Vedi anche