Partager via


CachedFileManager Classe

Définition

Permet aux applications de gérer les mises à jour en temps réel des fichiers.

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

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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

CompleteUpdatesAsync(IStorageFile)

Lance les mises à jour pour le fichier spécifié. Cette méthode contacte l’application qui a fourni le fichier pour effectuer les mises à jour.

DeferUpdates(IStorageFile)

Permet aux applications de différer les mises à jour en temps réel d’un fichier spécifié.

S’applique à

Voir aussi