CachedFileUpdaterActivatedEventArgs Klasse

Definition

Namespace:

Windows.ApplicationModel.Activation

Stellt Informationen zu dem aktivierten Ereignis bereit, das ausgelöst wird, wenn der Benutzer eine Datei speichert oder öffnet, die Updates von der App benötigt.

Javascript Dieser Typ wird als WebUICachedFileUpdaterActivatedEventArgs angezeigt.

public ref class CachedFileUpdaterActivatedEventArgs sealed : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CachedFileUpdaterActivatedEventArgs final : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CachedFileUpdaterActivatedEventArgs : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

Public NotInheritable Class CachedFileUpdaterActivatedEventArgs
Implements IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

Vererbung

Object Platform::Object IInspectable CachedFileUpdaterActivatedEventArgs

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IActivatedEventArgs ICachedFileUpdaterActivatedEventArgs IActivatedEventArgsWithUser

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
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 einen CachedFileUpdater-Aktivierungspunkt 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();
        }

Für C# args verweist für eine OnCachedFileUpdaterActivated-Überschreibung auf das Application-Objekt auf ein CachedFileUpdaterActivatedEventArgs-Objekt. Die OnCachedFileUpdaterActivated-Überschreibung befindet sich in der Datei App.xaml.cs, und die Activate -Methode befindet sich in der Datei CachedFileUpdaterPage.xaml.cs des Beispiels dateiauswahlverträge.

Hinweise

Weitere Informationen zum Bereitstellen von Updates für Dateien, die Ihre App anbietet, finden Sie unter Schnellstart: Bereitstellen von Dateidiensten über und in der Windows.Storage.Pickers.Provider-Namespacereferenz .

Ein CachedFileUpdaterActivatedEventArgs-Objekt wird an den aktivierten Ereignishandler der App übergeben, wenn der Benutzer eine Datei speichert, die Inhaltsverwaltung von der App erfordert. Dieser Aktivierungstyp wird durch den ActivationKind.CachedFileUpdater-Wert angegeben, der von der Kind-Eigenschaft zurückgegeben wird.

In JavaScript geschriebene Apps müssen Windows.UI.WebUI.WebUIApplication.activated-Ereignisse überwachen und behandeln.

Die UWP-App mit C++, C# oder Visual Basic implementiert in der Regel Aktivierungspunkte, indem Methoden des Application-Objekts überschrieben werden. Die CodeBehind-Dateien der Standardvorlage app.xaml enthalten immer eine Überschreibung für OnLaunched, aber das Definieren von Überschreibungen für andere Aktivierungspunkte wie OnCachedFileUpdaterActivated liegt bei Ihrem App-Code.

Alle Anwendungsüberschreibungen , die an einem Aktivierungsszenario beteiligt sind, sollten Window.Activate in ihren Implementierungen aufrufen.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	User

Eigenschaften

CachedFileUpdaterUI	Ruft die Benutzeroberfläche des Briefkastens der Dateiauswahl ab, die angezeigt wird, wenn eine Datei Updates von der App benötigt.
Kind	Ruft den Aktivierungstyp ab.
PreviousExecutionState	Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
SplashScreen	Ruft ein SplashScreen-Objekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.
User	Ruft den Benutzer ab, für den die App aktiviert wurde.

Weitere Informationen

• ActivationKind
• Windows.Storage.Provider
• Activated
• OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)
• Application
• Beispiel für Verträge für die Dateiauswahl