Freigeben über


Application Klasse

Definition

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
Application
Implementiert

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 Funktionen kapselt, einschließlich der folgenden:

Application implementiert das Singletonmuster, um gemeinsam genutzten Zugriff auf die zugehörigen Fenster-, Eigenschafts- und Ressourcenbereichsdienste bereitzustellen. Daher kann nur eine Instanz der Application -Klasse pro AppDomainerstellt werden.

Sie können eine Application mithilfe von Markup, Markup und CodeBehind oder Code implementieren. Wenn Application mit Markup implementiert ist, unabhängig davon, ob Markup oder Markup und CodeBehind, muss die Markupdatei als MSBuild-Element (Microsoft Build Engine) ApplicationDefinition konfiguriert werden.

Hinweis

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 Applicationzu erstellen. Xaml-Browseranwendungen (XBAPs) erfordern jedoch ein Application -Objekt.

Konstruktoren

Application()

Initialisiert eine neue Instanz der Application-Klasse.

Eigenschaften

Current

Ruft das Application-Objekt für die aktuelle AppDomain ab.

Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
MainWindow

Ruft das Hauptfenster der Anwendung ab oder legt dieses fest.

Properties

Ruft eine Auflistung von Eigenschaften für den Anwendungsbereich ab.

ResourceAssembly

Ruft den ab, der das Assembly Paket uniform Resource Identifiers (URIs) für Ressourcen in einer WPF-Anwendung bereitstellt, oder legt diesen fest.

Resources

Ruft eine Auflistung von Ressourcen für den Anwendungsbereich fest, z. B. Formate und Pinsel, oder legt diese fest.

ShutdownMode

Ruft die Bedingung ab, unter der die Shutdown()-Methode aufgerufen wird, oder legt diese fest.

StartupUri

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

ThemeMode

Kapselt eine Windows Presentation Foundation-Anwendung.

Windows

Ruft die instanziierten Fenster in einer Anwendung ab.

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.

(Geerbt von DispatcherObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindResource(Object)

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

GetContentStream(Uri)

Gibt einen Ressourcenstream für eine Inhaltsdatendatei zurück, die sich unter dem angegebenen Uri befindet (weitere Informationen finden Sie unter WPF-Anwendungsressource, Inhalts- und Datendateien).

GetCookie(Uri)

Ruft ein Cookie für den von einem Uri angegebenen Speicherort ab.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetRemoteStream(Uri)

Gibt einen Ressourcenstream für eine Ursprungssite-Datendatei zurück, die sich unter dem angegebenen Uri befindet (weitere Informationen finden Sie unter WPF-Anwendungsressource, Inhalts- und Datendateien).

GetResourceStream(Uri)

Gibt einen Ressourcenstream für eine Ressourcendatendatei zurück, die sich unter dem angegebenen Uri befindet (weitere Informationen finden Sie unter WPF-Anwendungsressource, Inhalts- und Datendateien).

GetType()

Ruft den 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 des 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 von einem Uri angegebenen Speicherort.

Shutdown()

Fährt eine Anwendung herunter.

Shutdown(Int32)

Fährt eine Anwendung herunter, 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 die angegebene Ressource.

VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.

(Geerbt von DispatcherObject)

Ereignisse

Activated

Tritt auf, wenn eine Anwendung als Vordergrundanwendung verwendet wird.

Deactivated

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

DispatcherUnhandledException

Tritt auf, wenn durch eine Anwendung eine Ausnahme ausgelöst wird, die jedoch nicht behandelt wird.

Exit

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

FragmentNavigation

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

LoadCompleted

Tritt ein, wenn der Inhalt, zu dem ein Navigator in der Anwendung navigiert ist, geladen und analysiert und mit dem Rendering begonnen wurde.

Navigated

Tritt ein, wenn der Inhalt, zu dem ein Navigator in der Anwendung navigiert, gefunden wurde. Dieses Ereignis ist über die -Eigenschaft verfügbar, auch wenn diese noch nicht vollständig geladen wurde.

Navigating

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

NavigationFailed

Tritt ein, wenn ein Fehler auftritt, während ein Navigator in der Anwendung zum angeforderten Inhalt navigiert.

NavigationProgress

Tritt während eines von einem Navigator in der Anwendung verwalteten Downloads regelmäßig ein, um Informationen zum Navigationsfortschritt bereitzustellen.

NavigationStopped

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

SessionEnding

Tritt ein, wenn ein Benutzer die Windows-Sitzung beendet, indem er sich abmeldet oder das Betriebssystem herunterfährt.

Startup

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

Explizite Schnittstellenimplementierungen

IQueryAmbient.IsAmbientPropertyAvailable(String)

Fragt ab, ob eine angegebene Ambiente-Eigenschaft 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) und die Properties Eigenschaften und Resources threadsicher.

Weitere Informationen