Application Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml

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

Kapselt die App und die verfügbaren Dienste.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application

Public Class Application

<Application />

Vererbung: Object IInspectable Application

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die Application-Klasse kapselt eine App und stellt die folgenden Dienste bereit:

App-Einstiegspunkt, insbesondere für verschiedene Aktivierungsverträge
Verwaltung der App-Lebensdauer
Ressourcen im App-Bereich
Unbehandelte Ausnahmeerkennung

Das Application-Objekt wird normalerweise im anfänglichen XAML-Code für App.xaml bereitgestellt. Die Standardprojektvorlagen in Visual Studio generieren eine App Von Application abgeleitete Klasse und bieten einen Einstiegspunkt, an dem Sie Initialisierungscode hinzufügen können.

Die App Klasse ordnet sich dem entsprechenden XAML zu, indem sie die generierte InitializeComponent Methode in ihrem Konstruktor aufruft. Sie können dem Konstruktor zusätzlichen Initialisierungscode hinzufügen, aber sie fügen in der App Regel nur Code hinzu, um Anwendungsereignissen Handler zuzuordnen. Für anderen Initialisierungscode sollten Sie mindestens eine Initialisierungsmethode wie OnLaunched außer Kraft setzen.

Das System verarbeitet die App-Lebensdauer, indem Es Ihre App angehalten, wenn der Benutzer zu einer anderen App oder zum Desktop wechselt, und ihre App wieder fortsetzt, wenn der Benutzer zurück zu ihr wechselt. Das System kann Ihre App jedoch auch beenden, während sie angehalten wird, um Ressourcen freizugeben. Sie sollten das Angehaltene Ereignis behandeln, um den App-Status im Falle einer Beendigung zu speichern, und die OnLaunched-Methode überschreiben, um den App-Zustand wiederherzustellen. Sie sollten das Resuming-Ereignis nur behandeln, wenn Sie angezeigte Inhalte aktualisieren müssen, die sich möglicherweise geändert haben, während die App angehalten wird. Sie müssen keinen anderen App-Zustand wiederherstellen, wenn die App fortgesetzt wird.

Aufgrund ihrer Position im Anwendungsmodell, Codegen und Aktivierungssequenz hat Application einige Einschränkungen für die XAML-Verwendung:

Außer den xmlns-Deklarationen und x:Class kann kein anderes Attribut im Application Stammtag angezeigt werden.
Versuchen Sie nicht, x:Class-Werte zu ändern, die aus der Projektvorlage App.xaml-Seiten stammen. Es gibt zusätzliche Abhängigkeiten zur Verwendung dieses Benennungsschemas, die in den Buildaktionen vorhanden sind.
Verbinden Sie die Application-Ereignishandler nicht in XAML. Die gesamte Ereignisverdrahtung sollte im Code (normalerweise im Konstruktor) erfolgen. Außerdem verwenden Sie in der Regel Methodenüberschreibungen anstelle der Ereignissyntax für ein Ereignis (z. B. überschreiben Sie OnActivated , um auf diese Phase des Anwendungslebenszyklus zu reagieren.)
Die einzigen erwarteten Eigenschaften für eine Application instance in XAML ist der Satz von Elementen, die die Application.Resources-Eigenschaft unter Verwendung einer XAML-Eigenschaftselementverwendung auffüllen sollen. Weitere Informationen finden Sie unter Ressourcen. Behandeln Sie das UnhandledException-Ereignis , um allgemeine Fehlerbehandlung für Alle Ausnahmen bereitzustellen, die ihr App-Code nicht abfangen kann.

Hinweis

Die Anwendungsdatei Standard muss den Namen habenApp.xaml.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RequiresPointerMode
1703	15063	HighContrastAdjustment

Konstruktoren

Application()

Initialisiert eine neue instance der Application-Klasse.

Eigenschaften

Current	Ruft das Application-Objekt für die aktuelle Anwendung ab.
DebugSettings	Ruft ein -Objekt ab, das deklariert, wie sich die App verhält, wenn sie in einer Debugumgebung ausgeführt wird.
FocusVisualKind	Ruft den Typ des visuellen Feedbacks ab, das eine App verwenden kann, um das UI-Element mit Fokus anzugeben, oder legt diesen fest. Diese Eigenschaft ist nur für Eingabegeräte gültig, die Schlüsselereignisse generieren können, z. B. eine Tastatur oder ein Spielpad.
HighContrastAdjustment	Ruft einen Wert ab, der angibt, ob das Framework visuelle Eigenschaften automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind, oder legt diesen fest.
RequestedTheme	Ruft einen Wert ab, der die Hell-Dunkel-Einstellung für das Gesamtdesign einer App bestimmt, oder legt diesen fest.
RequiresPointerMode	Ruft ab oder legt fest, ob eine UWP-App den Mausmodus unterstützt, der Zeigerinteraktionserfahrungen mit Nichtzeigereingabegeräten wie einem Spielpad oder einer Fernbedienung emuliert. (Dieses Verhalten erben alle geschachtelten Elemente.)
Resources	Ruft eine Auflistung von Anwendungsressourcen ab, z. B. Stile, Vorlagen und Pinsel.

Methoden

Exit()	Fährt die App herunter.
LoadComponent(Object, Uri)	Lädt eine XAML-Datei, die sich am angegebenen relativen Speicherort befindet, und konvertiert sie in eine instance des Objekts, das durch das Stammelement der XAML-Datei angegeben wird.
LoadComponent(Object, Uri, ComponentResourceLocation)	Lädt eine XAML-Datei, die sich am angegebenen relativen Speicherort befindet, und konvertiert sie in eine instance des Objekts, das durch das Stammelement der XAML-Datei angegeben wird.
OnActivated(IActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung mit anderen Mitteln als dem normalen Start aktiviert wird.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung im Hintergrund aktiviert wird.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung aufgrund eines Aktivierungsvertrags mit ActivationKind als CachedFileUpdater aktiviert wird.
OnFileActivated(FileActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung durch Datei öffnen aktiviert wird.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung über die Zuordnung des Dialogfelds "Datei öffnen" aktiviert wird.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung über die Dateispeicherdialogfeldzuordnung aktiviert wird.
OnLaunched(LaunchActivatedEventArgs)	Wird beim Starten der Anwendung aufgerufen. Überschreiben Sie diese Methode, um die Anwendungsinitialisierung durchzuführen und den anfänglichen Inhalt im zugeordneten Fenster anzuzeigen.
OnSearchActivated(SearchActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung über eine Suchzuordnung aktiviert wird.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Wird aufgerufen, wenn die Anwendung über die Freigabezuordnung aktiviert wird.
OnWindowCreated(WindowCreatedEventArgs)	Wird aufgerufen, wenn die Anwendung ein Fenster erstellt.
Start(ApplicationInitializationCallback)	Stellt den Einstiegspunkt bereit und fordert die Initialisierung der Anwendung an. Verwenden Sie den Rückruf, um die Application-Klasse zu instanziieren.

Ereignisse

EnteredBackground	Tritt auf, wenn die App vom Vordergrund in den Hintergrund wechselt.
LeavingBackground	Tritt auf, wenn die App vom Hintergrund in den Vordergrund wechselt.
Resuming	Tritt auf, wenn die Anwendung vom Status "Angehalten" in "Ausgeführt" wechselt.
Suspending	Tritt auf, wenn die Anwendung von einem anderen Zustand in den Zustand Angehalten wechselt.
UnhandledException	Tritt auf, wenn eine Ausnahme von App-Code behandelt werden kann, wie sie von einem fehler auf nativer Ebene Windows-Runtime weitergeleitet wird. Apps können das Vorkommen als in Ereignisdaten behandelt markieren.

Gilt für: