CachedFileManager Klasse

Referenz

Definition

Namespace:: Windows.Storage

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Beispiel für die Dateiauswahl (Windows 10)

Freigeben über