CachedFileManager-Klasse

CachedFileManager Class

Ermöglicht Apps die Verwaltung von Echtzeitaktualisierungen für Dateien.

Syntax


var cachedFileManager = Windows.Storage.CachedFileManager;

Attribute

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

Member

Der CachedFileManagerKlasse hat die folgenden Arten von Membern:

Methoden

The CachedFileManager Klasse verfügt über die folgenden Methoden. Mit C#, Visual Basic und C++ erbt er außerdem Methoden von Object Klasse.

MethodeBeschreibung
CompleteUpdatesAsync Initiates updates for the specified file.
DeferUpdates Lets apps defer real-time updates for a specified file.

 

Anmerkungen

Diese Klasse ist statisch und kann nicht instanziiert werden. Rufen Sie die Methoden stattdessen direkt auf.

Normalerweise initiiert Windows implizit Updates für Dateien, die von anderen Apps bereitgestellt werden, wenn sich diese Dateien ändern.  Allerdings können Sie steuern, wann Updates initiiert werden, indem Sie DeferUpdates aufrufen. Wenn Sie diese Methode verwenden, werden Updates verzögert, bis Sie CompleteUpdatesAsync aufrufen.

Beispiele

Die Dateiauswahlbeispiel zeigt Ihnen, wie CachedFileManager verwendet wird, um Updates einer Datei solange zu verzögern, bis die Anwendung die Änderung der Datei beendet hat.



if (file) {
    // Prevent updates to the remote version of the file until we finish making changes and call CompleteUpdatesAsync.
    Windows.Storage.CachedFileManager.deferUpdates(file);

    // Write to file
    Windows.Storage.FileIO.appendTextAsync(file, "Swift as a shadow").then(function () {

        // Complete updates. (May require Windows to ask for user input.)
        Windows.Storage.CachedFileManager.completeUpdatesAsync(file).then(function (fileUpdateStatus) {
            switch (fileUpdateStatus) {
                case Windows.Storage.Provider.FileUpdateStatus.complete:
                    // Perform additional tasks like notifying user of status
                    break;

                case Windows.Storage.Provider.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;
            }
        // Handle errors with an error function
        }, function (error) {
            // Handle errors encountered during completeUpdatesAsync
        });
    // Handle errors with an error function
    }, function (error) {
        // Handle errors encountered during appendTextAsync
    });
}

Im Beispiel ist file eine lokale Variable, die eine StorageFile enthält, welche die Datei darstellt, für die Aktualisierungen verzögert werden sollen.

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8 [Nur Windows Store-Apps]

Unterstützte Mindestversion (Server)

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

 

 

Anzeigen:
© 2016 Microsoft