CachedFileManager Klasse

  • Referenz

Definition

Namespace:
Windows.Storage
Bearbeiten

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

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
Vererbung
Object Platform::Object IInspectable CachedFileManager
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Beispiel für die Dateiauswahl zeigt, wie Sie einen CachedFileManager verwenden, um Updates für eine Datei zurückzustellen, bis die App die Änderung der Datei abgeschlossen hat.

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

Im Beispiel ist eine lokale Variable, file die eine StorageFile-Datei enthält, die die Datei darstellt, für die Updates zurückgeschoben werden sollen.

Hinweise

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

In der Regel initiiert Windows implizit Updates für Dateien, die von anderen Apps bereitgestellt werden, wenn sich diese Dateien ändern.  Sie können jedoch steuern, wann Updates initiiert werden, indem Sie DeferUpdates aufrufen. Wenn Sie diese Methode verwenden, werden sie zurückgestellt, bis Sie CompleteUpdatesAsync aufrufen, um sie zu initiieren.

Methoden

CompleteUpdatesAsync(IStorageFile)

Initiiert Updates für die angegebene Datei. Diese Methode kontaktiert die App, die die Datei bereitgestellt hat, um die Updates auszuführen.
DeferUpdates(IStorageFile)

Ermöglicht Apps das Zurückstellen von Echtzeitupdates für eine angegebene Datei.

Gilt für:

Weitere Informationen