CachedFileManager Kelas

Referensi

Definisi

Ruang nama:: Windows.Storage

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Memungkinkan aplikasi mengelola pembaruan real-time ke file.

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

Warisan: Object Platform::Object IInspectable CachedFileManager

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Sampel Pemilih file menunjukkan kepada Anda cara menggunakan CachedFileManager untuk menungguhkan pembaruan ke file hingga aplikasi selesai memodifikasi file.

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

Dalam contoh, file adalah variabel lokal yang berisi StorageFile yang mewakili file untuk menangguhkan pembaruan.

Keterangan

Kelas ini statis dan tidak dapat diinstansiasi. Panggil metode secara langsung sebagai gantinya.

Biasanya, Windows secara implisit memulai pembaruan untuk file yang disediakan oleh aplikasi lain ketika file tersebut berubah. Namun, Anda dapat mengontrol kapan pembaruan dimulai dengan memanggil DeferUpdates. Jika Anda menggunakan metode ini ditangguhkan hingga Anda memanggil CompleteUpdatesAsync untuk memulainya.

Metode

CompleteUpdatesAsync(IStorageFile)	Memulai pembaruan untuk file yang ditentukan. Metode ini menghubungi aplikasi yang menyediakan file untuk melakukan pembaruan.
DeferUpdates(IStorageFile)	Memungkinkan aplikasi menungguhkan pembaruan real-time untuk file tertentu.

Berlaku untuk

Lihat juga

Sampel pemilih file (Windows 10)