Application Klasse

Referenz

Definition

Namespace:: Microsoft.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

Stellt die aktuelle Anwendung und ihre verfügbaren Dienste dar.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Hinweise

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

App-Einstiegspunkt
Ressourcen im App-Bereich
Unbehandelte Ausnahmeerkennung

Das Application -Objekt wird in der Regel im anfänglichen XAML-Code für App.xaml bereitgestellt. Die Standardprojektvorlagen in Visual Studio generieren eine App Klasse, die von Application abgeleitet wird, 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 einen Handler für das UnhandledException-Ereignis zuzuordnen, oder legen Sie das RequestedTheme fest. Sie sollten anderen Initialisierungscode in der OnLaunched-Methode außer Kraft setzen.

Tipp

Weitere Informationen finden Sie unter Windows App SDK App-Lebenszyklus.

Aufgrund seiner Position im Anwendungsmodell hat codegen und aktivierungssequenz 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.
Die einzigen erwarteten Eigenschaften für eine Application instance in XAML ist der Satz von Elementen zum Auffüllen der Application.Resources-Eigenschaft mithilfe einer XAML-Eigenschaftselementverwendung. 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 Application Standard Datei muss den Namen habenApp.xaml.

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.
DispatcherShutdownMode	Ruft einen Wert ab, der angibt, ob die DispatcherQueue-Ereignisschleife beendet wird, wenn alle XAML-Fenster in einem Thread geschlossen werden, oder legt diesen fest.
FocusVisualKind	Ruft den Typ des visuellen Feedbacks ab, das eine App verwenden kann, um das UI-Element anzugeben, das den Fokus hat, oder legt diesen fest.
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.
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.
OnLaunched(LaunchActivatedEventArgs)	Wird beim Starten der Anwendung aufgerufen. Überschreiben Sie diese Methode, um die Anwendungsinitialisierung durchzuführen und ein neues Fenster zu erstellen.
Start(ApplicationInitializationCallback)	Stellt den Einstiegspunkt bereit und fordert die Initialisierung der Anwendung an. Verwenden Sie den angegebenen ApplicationInitializationCallback , um die Application-Klasse zu instanziieren.

Ereignisse

ResourceManagerRequested	Tritt beim Starten eines neuen WinUI-Threads auf, damit Sie eine benutzerdefinierte `IResourceManager` Implementierung bereitstellen können, die vom Framework zum Auflösen von Ressourcen-URIs verwendet werden kann.
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: