CachedFileManager Classe

Définition

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

Héritage

Object Platform::Object IInspectable CachedFileManager

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Exemples

L’exemple de sélecteur de fichiers vous montre comment utiliser un CachedFileManager pour différer les mises à jour d’un fichier jusqu’à ce que l’application ait terminé de modifier le fichier.

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

Dans l’exemple, file est une variable locale qui contient un StorageFile qui représente le fichier pour lequel différer les mises à jour.

Remarques

Cette classe est statique et ne peut pas être instanciée. Appelez les méthodes directement à la place.

En règle générale, Windows lance implicitement des mises à jour pour les fichiers fournis par d’autres applications lorsque ces fichiers changent.  Toutefois, vous pouvez contrôler le moment où les mises à jour sont lancées en appelant DeferUpdates. Si vous utilisez cette méthode sont différés jusqu’à ce que vous appeliez CompleteUpdatesAsync pour les lancer.

Méthodes

S’applique à

Voir aussi

• Exemple de sélecteur de fichiers (Windows 10)