CachedFileUpdaterUI Klasse

Referenz

Definition

Namespace:: Windows.Storage.Provider

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Wird für die Interaktion mit der Dateiauswahl verwendet, wenn Ihre App Dateiupdates über den Vertrag für cached File Updater bereitstellt.

public ref class CachedFileUpdaterUI sealed

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

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

Public NotInheritable Class CachedFileUpdaterUI

Vererbung: Object Platform::Object IInspectable CachedFileUpdaterUI

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 aktiviertes CachedFileUpdater-Ereignis reagiert wird.

// CachedFileUpdater activated event handler
protected override void OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs args)
{
    var CachedFileUpdaterPage = new SDKTemplate.CachedFileUpdaterPage();
    CachedFileUpdaterPage.Activate(args);
}

// Overloaded method to respond to CachedFileUpdater events
public void Activate(CachedFileUpdaterActivatedEventArgs args)
{
            // Get file picker UI
            cachedFileUpdaterUI = args.CachedFileUpdaterUI;

            cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;
            cachedFileUpdaterUI.UIRequested += CachedFileUpdaterUI_UIRequested;

            switch (cachedFileUpdaterUI.UpdateTarget)
            {
                case CachedFileTarget.Local:
                    scenarios = new List<Scenario> { new Scenario() { Title = "Get latest version", ClassType = typeof(FilePickerContracts.CachedFileUpdater_Local) } };
                    break;
                case CachedFileTarget.Remote:
                    scenarios = new List<Scenario> { new Scenario() { Title = "Remote file update", ClassType = typeof(FilePickerContracts.CachedFileUpdater_Remote) } };
                    break;
            }

            Window.Current.Activate();
        }

Enthält für C# args ein CachedFileUpdaterActivatedEventArgs-Objekt . Darüber hinaus befindet sich der OnCachedFileUpdaterActivated in der Datei App.xaml.cs, und die Activate -Methode befindet sich in der Datei CachedFileUpdaterPage.xaml.cs des Beispiels Dateiauswahlverträge.

Hinweise

Rufen Sie ein CachedFileUpdaterUI-Objekt mithilfe der CachedFileUpdaterActivatedEventArgs.CachedFileUpdaterUI-Eigenschaft ab.

Eigenschaften

Title	Ruft den Titel ab, der links oben in der Dateiauswahl angezeigt werden soll, oder legt diesen fest. Der Titel identifiziert den Speicherort oder den Kontext der Seite der App (die in der Dateiauswahl-UI gehostet wird) für den Benutzer.
UIStatus	Ruft einen Enumerationswert ab, der die status der Benutzeroberfläche der Dateiauswahl angibt.
UpdateRequest	Ruft die Dateiupdateanforderung ab, die derzeit vom zwischengespeicherten Dateiupdater verarbeitet wird.
UpdateTarget	Ruft einen Wert ab, der angibt, welche Version der Datei aktualisiert werden muss: die lokale Version oder die Version im Repository der App.

Methoden

GetDeferral()

Ruft ein Objekt ab, das zum asynchronen Abschließen einer Dateiaktualisierungsanforderung verwendet wird.

Ereignisse

FileUpdateRequested

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

UIRequested

Wird ausgelöst, wenn die aufrufende App die Benutzeroberfläche des Briefkastens für die Dateiauswahl anzeigen muss, die durch das CachedFileUpdaterUI-Objekt dargestellt wird.

Ein Server kann die Initialisierung der Benutzeroberfläche zurückstellen, bis er dieses Ereignis empfängt.

Gilt für:

Weitere Informationen

Beispiel für Verträge für die Dateiauswahl

Freigeben über