FileActivatedEventArgs Klasse

Definition

Namespace:

Windows.ApplicationModel.Activation

Stellt Daten bereit, wenn eine App aktiviert wird, da es sich um die App handelt, die einer Datei zugeordnet ist.

Javascript Dieser Typ wird als WebUIFileActivatedEventArgs angezeigt.

public ref class FileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Vererbung

Object Platform::Object IInspectable FileActivatedEventArgs

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider 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

Der OnFileActivated-Ereignishandler für das Application-Objekt empfängt alle Dateiaktivierungsereignisse.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation

      ' The number of files received is args.Files.Size
      ' The first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& /* args */)
{
    // TODO: Handle file activation.

    // The number of files received is args.Files().Size().
    // The first file is args.Files().GetAt(0).Name().
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
       // TODO: Handle file activation

       // The number of files received is args->Files->Size
       // The first file is args->Files->GetAt(0)->Name
}

Hinweise

Auf dieses Objekt wird zugegriffen, wenn Sie einen Ereignishandler implementieren, um auf aktivierte Ereignisse zu reagieren, wenn ActivationKindDatei ist.

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 OnFileActivated liegt bei Ihrem App-Code.

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

Beachten Sie, dass Sie beim Aktivieren Ihrer App für den Dateivertrag auf die Daten mithilfe der StorageFile-Objekte zugreifen müssen, die über die Files-Eigenschaft an Ihre App übergeben werden. Sie sollten nicht versuchen, auf den Pfad der Datei zuzugreifen, da Ihre App möglicherweise keine Berechtigung für den Speicherort der Datei hat.

Versionsverlauf

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

Eigenschaften

CallerPackageFamilyName	Der Paketfamilienname der App, die Ihre App gestartet hat.
CurrentlyShownApplicationViewId	Ruft den Bezeichner für die aktuell angezeigte App-Ansicht ab.
Files	Ruft die Dateien ab, für die die App aktiviert wurde.
Kind	Ruft den Aktivierungstyp ab.
NeighboringFilesQuery	Ruft die benachbarten Dateien der Dateien ab, für die die App aktiviert wurde.
PreviousExecutionState	Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
SplashScreen	Ruft das Begrüßungsbildschirmobjekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.
User	Ruft den Benutzer ab, für den die App aktiviert wurde.
Verb	Ruft die Aktion ab, die der aktivierten Datei zugeordnet ist.
ViewSwitcher	Stellt das -Objekt bereit, mit dem Sie die Ansicht für die Anwendung festlegen können.

Weitere Informationen

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• Beispiel für Assoziationsstart
• Behandeln der Dateiaktivierung
• Richtlinien für Dateitypen und URIs
• Beispiel zum Starten der Zuordnung (Windows 10)