Application Klasse

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Stellt die aktuelle Anwendung und die 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 mit 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 dieser abgeleitet wird, und stellt einen Einstiegspunkt bereit, an dem Sie Initialisierungscode hinzufügen können.

Die App Klasse ordnet sich dem entsprechenden XAML-Code zu, indem die generierte Methode im Konstruktor aufgerufen wird InitializeComponent . Sie können dem Konstruktor zusätzlichen Initialisierungscode hinzufügen. In der App Regel fügen Sie jedoch nur Code hinzu, um einen Handler für das UnhandledException-Ereignis zuzuordnen oder den RequestedTheme festzulegen. Sie sollten anderen Initialisierungscode in die OnLaunched-Methode außer Kraft setzen.

Tip

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

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

  • Abgesehen von den XMLn-Deklarationen und x:Class kann kein anderes Attribut im Application Stammtag angezeigt werden.
  • Versuchen Sie nicht, x:Class-Werte zu ändern, die von den Seiten der Projektvorlage "App.xaml" 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. Alle Ereignisverkabelungen sollten im Code ausgeführt werden (in der Regel im Konstruktor).
  • Die einzigen erwarteten Eigenschaften für eine Application Instanz in XAML sind die Elemente, die die Application.Resources-Eigenschaft mit einer XAML-Eigenschaftselementverwendung auffüllen sollen. Weitere Informationen finden Sie unter "Ressourcen".
  • Behandeln Sie das UnhandledException-Ereignis , um eine allgemeine Fehlerbehandlung für alle Ausnahmen bereitzustellen, die vom App-Code nicht erfasst werden.

Hinweis

Die Application Hauptdatei muss benannt App.xamlwerden.

Konstruktoren

Name Beschreibung
Application()

Initialisiert eine neue Instanz der Application-Klasse .

Eigenschaften

Name Beschreibung
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

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die DispatcherQueue-Ereignisschleife beendet wird, wenn alle XAML-Fenster in einem Thread geschlossen werden.
FocusVisualKind

Ruft den Typ des visuellen Feedbacks ab, das eine App verwenden kann, um das UI-Element anzugeben, das den Fokus besitzt, oder legt diesen fest.
HighContrastAdjustment

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Framework visuelle Eigenschaften automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind.
RequestedTheme

Dient zum Abrufen oder Festlegen eines Werts, der die Hell-Dunkel-Einstellung für das allgemeine Design einer App bestimmt.
Resources

Ruft eine Auflistung von ressourcen mit Anwendungsbereich ab, z. B. Stile, Vorlagen und Pinsel.

Methoden

Name Beschreibung
Exit()

Beendet die App.
LoadComponent(Object, Uri, ComponentResourceLocation)

Lädt eine XAML-Datei, die sich am angegebenen relativen Speicherort befindet, und konvertiert sie in eine Instanz des Objekts, das durch das Stammelement der XAML-Datei angegeben wird.
LoadComponent(Object, Uri)

Lädt eine XAML-Datei, die sich am angegebenen relativen Speicherort befindet, und konvertiert sie in eine Instanz des Objekts, das durch das Stammelement der XAML-Datei angegeben wird.
OnLaunched(LaunchActivatedEventArgs)

Wird aufgerufen, wenn die Anwendung gestartet wird. Überschreiben Sie diese Methode, um die Anwendungsinitialisierung durchzuführen und ein neues Fenster zu erstellen.
Start(ApplicationInitializationCallback)

Stellt den Einstiegspunkt und die Initialisierung der Anwendung an. Verwenden Sie den angegebenen ApplicationInitializationCallback , um die Application-Klasse zu instanziieren.

Ereignisse

Name Beschreibung
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 soll.
UnhandledException

Tritt auf, wenn eine Ausnahme von App-Code behandelt werden kann, wie von einem systemeigenen Windows-Runtime Fehler weitergeleitet. Apps können das Vorkommen in Ereignisdaten als behandelt markieren.

Gilt für:

Weitere Informationen