CachedFileUpdater.SetUpdateInformation 方法

定义

命名空间:

Windows.Storage.Provider

为本地文件配置更新策略。

public:
 static void SetUpdateInformation(IStorageFile ^ file, Platform::String ^ contentId, ReadActivationMode readMode, WriteActivationMode writeMode, CachedFileOptions options);

 static void SetUpdateInformation(IStorageFile const& file, winrt::hstring const& contentId, ReadActivationMode const& readMode, WriteActivationMode const& writeMode, CachedFileOptions const& options);

public static void SetUpdateInformation(IStorageFile file, string contentId, ReadActivationMode readMode, WriteActivationMode writeMode, CachedFileOptions options);

function setUpdateInformation(file, contentId, readMode, writeMode, options)

Public Shared Sub SetUpdateInformation (file As IStorageFile, contentId As String, readMode As ReadActivationMode, writeMode As WriteActivationMode, options As CachedFileOptions)

参数

file

IStorageFile

本地文件。

contentId

String

Platform::String

winrt::hstring

本地文件的唯一标识符。

可以使用此标识符将应用存储库中的文件与本地文件相关联。 当 Windows 请求更新时，你可以使用此 contentId 在应用的存储库中标识正确的文件。

readMode

ReadActivationMode

一个 值，该值指定在从应用的 MostRecentlyUsedList 或 FutureAccessList 检索本地文件之前，Windows 是否会请求更新。

writeMode

WriteActivationMode

一个 值，该值指定其他应用是否可以写入本地文件，如果是，则指定 Windows 是否在写入本地文件后请求更新。

options

CachedFileOptions

一个 值，该值指定 Windows 请求更新时的其他情况和行为。

例如，你可能要求 Windows 在每次使用 CachedFileOptions.RequireUpdateOnAccess 访问本地文件时请求更新。 有关可能选项的详细信息，请参阅 CachedFileOptions。

注解

若要使用此方法，应用必须参与缓存文件更新程序合约。

你可以使用此方法控制其他应用如何访问你的应用提供的文件，并控制 Windows 何时请求更新该文件。