CachedFileManager Класс

  • Ссылка

Определение

Пространство имен:
Windows.Storage
Изменить

Позволяет приложениям управлять обновлениями файлов в режиме реального времени.

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
Наследование
Object Platform::Object IInspectable CachedFileManager
Атрибуты
ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В примере средства выбора файлов показано, как использовать CachedFileManager для отсрочки обновления файла до тех пор, пока приложение не завершит изменение файла.

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

В этом примере — это локальная переменная, file содержащая StorageFile , представляющий файл, для который необходимо отложить обновления.

Комментарии

Этот класс является статическим и не может быть создан. Вместо этого вызовите методы напрямую.

Как правило, Windows неявно инициирует обновления для файлов, предоставляемых другими приложениями при изменении этих файлов.  Однако вы можете управлять тем, когда инициируются обновления, путем вызова DeferUpdates. Если вы используете этот метод, откладываются до вызова CompleteUpdatesAsync для их инициации.

Методы

CompleteUpdatesAsync(IStorageFile)

Инициирует обновления для указанного файла. Этот метод связывается с приложением, которое предоставило файл для выполнения обновлений.
DeferUpdates(IStorageFile)

Позволяет приложениям откладывать обновления для указанного файла в режиме реального времени.

Применяется к

См. также раздел