Application Klasse

Definition

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Kapselt eine Windows Presentation Foundation-Anwendung.

public ref class Application : System::Windows::Threading::DispatcherObject
public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient
public class Application : System.Windows.Threading.DispatcherObject
public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient
type Application = class
    inherit DispatcherObject
type Application = class
    inherit DispatcherObject
    interface IQueryAmbient
Public Class Application
Inherits DispatcherObject
Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient
Vererbung
Object
DispatcherObject
Application
Implementiert
IQueryAmbient

Beispiele

Das folgende Beispiel zeigt, wie eine Standardanwendung nur mithilfe von Markup definiert wird:

<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />

Das folgende Beispiel zeigt, wie eine Standardanwendung nur mithilfe von Code definiert wird:

using System;
using System.Windows;

namespace SDKSample
{
    public class AppCode : Application
    {
        // Entry point method
        [STAThread]
        public static void Main()
        {
            AppCode app = new AppCode();
            app.Run();
        }
    }
}


Imports System.Windows

Namespace SDKSample
    Public Class AppCode
        Inherits Application
        ' Entry point method
        <STAThread>
        Public Shared Sub Main()
            Dim app As New AppCode()
            app.Run()
        End Sub
    End Class
End Namespace

Das folgende Beispiel zeigt, wie eine Standardanwendung mithilfe einer Kombination aus Markup und CodeBehind definiert wird.

<Application 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  x:Class="SDKSample.App" />

using System.Windows;

namespace SDKSample
{
    public partial class App : Application { }
}


Imports System.Windows

Namespace SDKSample
    Partial Public Class App
        Inherits Application
    End Class
End Namespace

Hinweise

Application ist eine Klasse, die WPF anwendungsspezifische Funktionalität kapselt, einschließlich der folgenden:

Application implementiert das Singleton-Muster, um gemeinsam genutzten Zugriff auf seine Fenster-, Eigenschafts- und Ressourcenbereichsdienste bereitzustellen. Folglich kann pro Klasse nur eine Instanz Application erstellt AppDomainwerden.

Sie können ein Application Markup, Markup und CodeBehind oder Code implementieren. Wenn Application mit Markup implementiert wird, unabhängig davon, ob Markup oder Markup und CodeBehind, muss die Markupdatei als Microsoft Buildmodul (MSBuild) ApplicationDefinition Element konfiguriert werden.

Note

Eine eigenständige Anwendung erfordert Application kein Objekt. Es ist möglich, eine benutzerdefinierte static Einstiegspunktmethode (Main) zu implementieren, die ein Fenster öffnet, ohne eine Instanz von Application. Xaml-Browseranwendungen (XBAPs) erfordern jedoch ein Application Objekt.

Konstruktoren

Name Beschreibung
Application()

Initialisiert eine neue Instanz der Application-Klasse.

Eigenschaften

Name Beschreibung
Current

Ruft das Application Objekt für den aktuellen AppDomainab.
Dispatcher

Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
MainWindow

Ruft ab oder legt das Hauptfenster der Anwendung fest.
Properties

Ruft eine Auflistung von Anwendungsbereichseigenschaften ab.
ResourceAssembly

Dient zum Abrufen oder Festlegen des Assembly, der die URIs (Uniform Resource Identifiers) für Ressourcen in einer WPF-Anwendung bereitstellt.
Resources

Dient zum Abrufen oder Festlegen einer Auflistung von Ressourcen im Anwendungsbereich, z. B. Stile und Pinsel.
ShutdownMode

Dient zum Abrufen oder Festlegen der Bedingung, die bewirkt, dass die Shutdown() Methode aufgerufen wird.
StartupUri

Ruft eine Benutzeroberfläche ab, die automatisch angezeigt wird, wenn eine Anwendung gestartet wird, oder legt diese fest.
ThemeMode

Dient zum Abrufen oder Festlegen des Fluent-Designmodus der Anwendung.
Windows

Ruft die instanziierten Fenster in einer Anwendung ab.

Methoden

Name Beschreibung
CheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
FindResource(Object)

Sucht nach einer Benutzeroberfläche-Ressource, z. B. einer Style oder Brush, mit dem angegebenen Schlüssel, und löst eine Ausnahme aus, wenn die angeforderte Ressource nicht gefunden wird (siehe XAML-Ressourcen).
GetContentStream(Uri)

Gibt einen Ressourcendatenstrom für eine Inhaltsdatendatei zurück, die sich in der angegebenen Uri befindet (siehe WPF Application Resource, Content, and Data Files).
GetCookie(Uri)

Ruft ein Cookie für den durch eine Uri.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetRemoteStream(Uri)

Gibt einen Ressourcendatenstrom für eine Ursprungsdatendatei zurück, die sich in der angegebenen Uri befindet (siehe WPF Application Resource, Content, and Data Files).
GetResourceStream(Uri)

Gibt einen Ressourcendatenstrom für eine Ressourcendatendatei zurück, die sich in der angegebenen Uri befindet (siehe WPF Application Resource, Content, and Data Files).
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
LoadComponent(Object, Uri)

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

Lädt eine XAML-Datei, die sich am angegebenen URI (Uniform Resource Identifier) befindet, und konvertiert sie in eine Instanz des Objekts, das durch das Stammelement der XAML-Datei angegeben wird.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
OnActivated(EventArgs)

Löst das Activated-Ereignis aus.
OnDeactivated(EventArgs)

Löst das Deactivated-Ereignis aus.
OnExit(ExitEventArgs)

Löst das Exit-Ereignis aus.
OnFragmentNavigation(FragmentNavigationEventArgs)

Löst das FragmentNavigation-Ereignis aus.
OnLoadCompleted(NavigationEventArgs)

Löst das LoadCompleted-Ereignis aus.
OnNavigated(NavigationEventArgs)

Löst das Navigated-Ereignis aus.
OnNavigating(NavigatingCancelEventArgs)

Löst das Navigating-Ereignis aus.
OnNavigationFailed(NavigationFailedEventArgs)

Löst das NavigationFailed-Ereignis aus.
OnNavigationProgress(NavigationProgressEventArgs)

Löst das NavigationProgress-Ereignis aus.
OnNavigationStopped(NavigationEventArgs)

Löst das NavigationStopped-Ereignis aus.
OnSessionEnding(SessionEndingCancelEventArgs)

Löst das SessionEnding-Ereignis aus.
OnStartup(StartupEventArgs)

Löst das Startup-Ereignis aus.
Run()

Startet eine Windows Presentation Foundation-Anwendung.
Run(Window)

Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster.
SetCookie(Uri, String)

Erstellt ein Cookie für den durch eine Uri.
Shutdown()

Beendet eine Anwendung.
Shutdown(Int32)

Beendet eine Anwendung, die den angegebenen Exitcode an das Betriebssystem zurückgibt.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TryFindResource(Object)

Sucht nach der angegebenen Ressource.
VerifyAccess()

Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)

Ereignisse

Name Beschreibung
Activated

Tritt auf, wenn eine Anwendung zur Vordergrundanwendung wird.
Deactivated

Tritt auf, wenn eine Anwendung nicht mehr die Vordergrundanwendung ist.
DispatcherUnhandledException

Tritt auf, wenn eine Ausnahme von einer Anwendung ausgelöst, aber nicht behandelt wird.
Exit

Tritt direkt vor dem Herunterfahren einer Anwendung auf und kann nicht abgebrochen werden.
FragmentNavigation

Tritt ein, wenn ein Navigator in der Anwendung mit der Navigation zu einem Inhaltsfragment beginnt, tritt die Navigation sofort auf, wenn sich das gewünschte Fragment im aktuellen Inhalt befindet oder nachdem der QUELL-XAML-Inhalt geladen wurde, wenn sich das gewünschte Fragment in einem anderen Inhalt befindet.
LoadCompleted

Tritt auf, wenn Inhalte, zu denen ein Navigator in der Anwendung navigiert wurde, geladen, analysiert und mit dem Rendern begonnen wurde.
Navigated

Tritt auf, wenn der Inhalt, zu dem ein Navigator in der Anwendung navigiert wird, gefunden wurde, obwohl das Laden möglicherweise nicht abgeschlossen wurde.
Navigating

Tritt auf, wenn eine neue Navigation von einem Navigator in der Anwendung angefordert wird.
NavigationFailed

Tritt auf, wenn ein Fehler auftritt, während ein Navigator in der Anwendung zu dem angeforderten Inhalt navigiert.
NavigationProgress

Tritt in regelmäßigen Abständen während eines Downloads auf, der von einem Navigator in der Anwendung verwaltet wird, um Navigationsfortschrittsinformationen bereitzustellen.
NavigationStopped

Tritt auf, wenn die StopLoading Methode eines Navigators in der Anwendung aufgerufen wird oder eine neue Navigation von einem Navigator angefordert wird, während eine aktuelle Navigation ausgeführt wird.
SessionEnding

Tritt auf, wenn der Benutzer die Windows Sitzung beendet, indem das Betriebssystem abgemeldet oder heruntergefahren wird.
Startup

Tritt auf, wenn die Run() Methode des Application Objekts aufgerufen wird.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IQueryAmbient.IsAmbientPropertyAvailable(String)

Fragt ab, ob eine angegebene Umgebungseigenschaft im aktuellen Bereich verfügbar ist.

Gilt für:

Threadsicherheit

Die öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Darüber hinaus sind die FindResource(Object) Methoden und TryFindResource(Object) Methoden und PropertiesResources Eigenschaften threadsicher.

Weitere Informationen