CachedFileUpdaterUI.FileUpdateRequested Ereignis

Definition

Namespace:

Windows.Storage.Provider

Wird ausgelöst, wenn Windows ein Dateiupdate anfordert. Dieses Ereignis wird für jedes angeforderte Update einmal ausgelöst.

// 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) 

Ereignistyp

TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs>

Beispiele

Im Beispiel für Verträge für die Dateiauswahl wird veranschaulicht, wie auf ein FileUpdateRequested-Ereignis reagiert wird.

// 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 enthält ein FileUpdateRequestedEventArgs-Objekt .

Hinweise

Wenn Ihre App am Vertrag "Cached File Updater" teilnimmt, müssen Sie sich für dieses Ereignis im aktivierten Ereignishandler Ihrer App registrieren, wo Sie nach ActivationKind.CachedFileUpdater suchen. Sie müssen auf dieses FileUpdateRequested-Ereignis reagieren, indem Sie die Datei aktualisieren und den FileUpdateRequest.Status der Anforderung festlegen. Verwenden Sie cachedFileUpdaterUI. UpdateTarget-Eigenschaft , um zu bestimmen, ob Ihre App die Versionsdatei in ihrem Repository oder die lokal zwischengespeicherte Kopie der Datei als Reaktion auf die Anforderung aktualisieren soll.

Sie können auf Informationen zum angeforderten Update zugreifen, indem Sie die FileUpdateRequestedEventArgs.Request-Eigenschaft für das Objekt verwenden, das an Ihren FileUpdateRequested-Ereignishandler übergeben wird. 

Wenn Sie eine Benutzereingabe benötigen, um das Update abzuschließen, legen Sie FileUpdateRequest.Status auf FileUpdateStatus.UserInputNeeded fest , und schließen Sie die Anforderung ab. Wenn eine Benutzerinteraktion verfügbar ist, wird eine andere DateiUpdateRequested ausgelöst, und Ihre App kann Benutzereingaben abrufen und die Anforderung abschließen.