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)	允许应用延迟指定文件的实时更新。

另请参阅

• 文件选取器示例 (Windows 10)