FileUpdateRequest Klasse

Definition

Namespace:

Windows.Storage.Provider

Stellt Informationen zu einem angeforderten Dateiupdate bereit, damit die App die Anforderung abschließen kann.

public ref class FileUpdateRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileUpdateRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileUpdateRequest

Public NotInheritable Class FileUpdateRequest

Vererbung

Object Platform::Object IInspectable FileUpdateRequest

Attribute

ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im Beispiel für Verträge für die Dateiauswahl wird veranschaulicht, wie auf ein FileUpdateRequested-Ereignis reagiert wird , einschließlich der Verwendung von Request zum Abrufen von FileUpdateRequest.

// 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, verwenden Sie diese Klasse, um zu reagieren, wenn Windows FileUpdateRequested-Ereignisse auslöst, um Dateiupdates anzufordern. Sie können über Ihren Ereignishandler mithilfe der FileUpdateRequestedEventArgs auf diese Klasse zugreifen. Request-Eigenschaft . Als Teil Ihrer Antwort auf ein FileUpdateRequested-Ereignis müssen Sie die Status-Eigenschaft dieser Klasse festlegen, um die status des Updates anzugeben.

Erfahren Sie mehr über das Reagieren auf Updateanforderungen in FileUpdateRequested und FileUpdateRequestedEventArgs.

Wenn Ihre App das Update nicht abschließen kann, bevor sie von ihrem FileUpdateRequested-Ereignishandler zurückgegeben wird , können Sie die GetDeferral-Eigenschaft verwenden, um das Update asynchron abzuschließen.

Eigenschaften

ContentId	Ruft den eindeutigen Bezeichner ab, der verwendet wird, um die lokale Version einer Datei der entsprechenden Remoteversion zuzuordnen.
File	Ruft ein StorageFile-Objekt ab, das die lokal zwischengespeicherte Kopie der zu aktualisierenden Datei darstellt.
Status	Ruft die status des Updates ab oder legt sie fest. Diese Eigenschaft wird als Antwort auf ein FileUpdateRequested-Ereignis festgelegt.
UserInputNeededMessage	Ruft eine Nachricht an den Benutzer ab, die angibt, dass eine Benutzereingabe erforderlich ist, um fileUpdateRequest abzuschließen, oder legt diese fest.

Methoden

GetDeferral()	Ruft ein Objekt ab, das verwendet wird, um eine Aktualisierung asynchron abzuschließen.
UpdateLocalFile(IStorageFile)	Geben Sie eine neue Version der lokalen Datei an, um die Remotedatei darzustellen.