CachedFileUpdaterUI.FileUpdateRequested Событие

Определение

Пространство имен:

Windows.Storage.Provider

Срабатывает, когда Windows запрашивает обновление файла. Это событие срабатывает один раз для каждого запрошенного обновления.

// Register
event_token FileUpdateRequested(TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void FileUpdateRequested(event_token const* cookie) const;

// Revoke with event_revoker
CachedFileUpdaterUI::FileUpdateRequested_revoker FileUpdateRequested(auto_revoke_t, TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs> FileUpdateRequested;

function onFileUpdateRequested(eventArgs) { /* Your code */ }
cachedFileUpdaterUI.addEventListener("fileupdaterequested", onFileUpdateRequested);
cachedFileUpdaterUI.removeEventListener("fileupdaterequested", onFileUpdateRequested);
- or -
cachedFileUpdaterUI.onfileupdaterequested = onFileUpdateRequested;

Public Custom Event FileUpdateRequested As TypedEventHandler(Of CachedFileUpdaterUI, FileUpdateRequestedEventArgs) 

Тип события

TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs>

Примеры

В примере контрактов средства выбора файлов показано, как реагировать на событие FileUpdateRequested.

// Event handler
void CachedFileUpdaterUI_FileUpdateRequested(CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
{
    fileUpdateRequest = args.Request;
    fileUpdateRequestDeferral = fileUpdateRequest.GetDeferral();
    switch (cachedFileUpdaterUI.UIStatus)
    {
        case UIStatus.Hidden:
            fileUpdateRequest.Status = FileUpdateStatus.UserInputNeeded;
            fileUpdateRequestDeferral.Complete();
            break;
        case UIStatus.Visible:
            break;
        case UIStatus.Unavailable:
            fileUpdateRequest.Status = FileUpdateStatus.Failed;
            fileUpdateRequestDeferral.Complete();
            break;
    }
}

// Register for the event
cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;

args содержит объект FileUpdateRequestedEventArgs .

Комментарии

Если приложение участвует в контракте кэшированных файлов, необходимо зарегистрироваться для этого события в обработчике активированных событий приложения, где вы проверка для ActivationKind.CachedFileUpdater. Необходимо ответить на это событие FileUpdateRequested, обновив файл и задав fileUpdateRequest.Status запроса. Используйте CachedFileUpdaterUI. Свойство UpdateTarget позволяет определить, следует ли приложению обновлять файл версии в репозитории или локально кэшированную копию файла в ответ на запрос.

Получить доступ к сведениям о запрошенном обновлении можно с помощью свойства FileUpdateRequestedEventArgs.Request объекта, передаваемого в обработчик событий FileUpdateRequested. 

Если для завершения обновления требуется ввод данных пользователем, задайте для параметра FileUpdateRequest.Status значение FileUpdateStatus.UserInputNeeded и завершите запрос. Если взаимодействие с пользователем доступно, срабатывает другой файл FileUpdateRequested, и ваше приложение сможет получить входные данные пользователя и выполнить запрос.