CachedFileManager Classe

Référence

Définition

Espace de noms:: Windows.Storage

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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: ContractVersionAttribute MarshalingBehaviorAttribute

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

Exemple de sélecteur de fichiers (Windows 10)