Freigeben über


Application Klasse

Definition

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

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, 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.

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.

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:

Weitere Informationen