Application Application Application Application Class

Definition

Kapselt eine Windows Presentation Foundation-Anwendung.Encapsulates a Windows Presentation Foundation application.

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

Beispiele

Das folgende Beispiel zeigt, wie eine standard-Anwendung ist nur mit Markup definiert:The following example shows how a standard application is defined using only markup:

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

Das folgende Beispiel zeigt, wie eine standardanwendung mit definiert wird nur code:The following example shows how a standard application is defined using only code:

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 Microsoft.VisualBasic
Imports System
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 mit einer Kombination aus Markup und CodeBehind definiert.The following example shows how a standard application is defined using a combination of markup and code-behind.

<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 Microsoft.VisualBasic
Imports System.Windows

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

Hinweise

Application ist eine Klasse, kapselt WPFWPF programmspezifische Funktionen, einschließlich der folgenden:Application is a class that encapsulates WPFWPF application-specific functionality, including the following:

Application implementiert das Singletonmuster verwenden, um den freigegebenen Zugriff auf die Fenster, Eigenschaft und Ressource Scope-Dienste bereitzustellen.Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. Daher nur eine Instanz der Application Klasse erstellt werden kann, pro AppDomain.Consequently, only one instance of the Application class can be created per AppDomain.

Sie können die implementieren eine Application mit Markup, Markup und Code-Behind oder Code.You can implement an Application using markup, markup and code-behind, or code. Wenn Application mit Markup implementiert wird, ob die Markupdatei Markup oder Markup und CodeBehind, als konfiguriert werden muss ein Microsoft-Build-Engine (MSBuild)Microsoft build engine (MSBuild) ApplicationDefinition Element.If Application is implemented with markup, whether markup or markup and code-behind, the markup file must be configured as an Microsoft-Build-Engine (MSBuild)Microsoft build engine (MSBuild) ApplicationDefinition item.

Hinweis

Eine eigenständige Anwendung erfordert kein Application Objekt; es ist möglich, die Implementierung eines benutzerdefinierten static Einstiegspunktmethode (Main), die öffnet ein Fenster ohne eine Instanz des Application.A standalone application does not require an Application object; it is possible to implement a custom static entry point method (Main) that opens a window without creating an instance of Application. Allerdings XAML-Browseranwendungen (XAML browser applications; XBAPs)XAML browser applications (XBAPs) erfordern eine Application Objekt.However, XAML-Browseranwendungen (XAML browser applications; XBAPs)XAML browser applications (XBAPs) require an Application object.

Konstruktoren

Application() Application() Application() Application()

Initialisiert eine neue Instanz der Application-Klasse.Initializes a new instance of the Application class.

Eigenschaften

Current Current Current Current

Ruft die Application Objekt für die aktuelle AppDomain.Gets the Application object for the current AppDomain.

Dispatcher Dispatcher Dispatcher Dispatcher

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
MainWindow MainWindow MainWindow MainWindow

Übernimmt oder bestimmt das Hauptfenster der Anwendung.Gets or sets the main window of the application.

Properties Properties Properties Properties

Ruft eine Auflistung von Eigenschaften für den Anwendungsbereich ab.Gets a collection of application-scope properties.

ResourceAssembly ResourceAssembly ResourceAssembly ResourceAssembly

Ruft ab oder legt diesen fest der Assembly , der das Pack bereitstellt Uniform Resource Identifier (URIs)uniform resource identifiers (URIs) für Ressourcen in einem WPFWPF Anwendung.Gets or sets the Assembly that provides the pack Uniform Resource Identifier (URIs)uniform resource identifiers (URIs) for resources in a WPFWPF application.

Resources Resources Resources Resources

Übernimmt oder bestimmt eine Auflistung von Anwendungsbereich-Ressourcen, z. B. Formate und Pinsel.Gets or sets a collection of application-scope resources, such as styles and brushes.

ShutdownMode ShutdownMode ShutdownMode ShutdownMode

Ruft ab oder legt die Bedingung, die bewirkt, dass die Shutdown() Methode, die aufgerufen werden.Gets or sets the condition that causes the Shutdown() method to be called.

StartupUri StartupUri StartupUri StartupUri

Ruft eine Benutzeroberfläche ab, die automatisch angezeigt wird, wenn die Anwendung startet, oder legt diese fest.Gets or sets a UI that is automatically shown when an application starts.

Windows Windows Windows Windows

Ruft die instanziierten Fenster in einer Anwendung ab.Gets the instantiated windows in an application.

Methoden

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Bestimmt, ob der aufrufende Thread den Zugriff auf diese kann DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindResource(Object) FindResource(Object) FindResource(Object) FindResource(Object)

Sucht eine Benutzeroberfläche (User Interface, UI)user interface (UI)-Ressource, z. B. einen Style oder einen Brush mit dem angegebenen Schlüssel und löst eine Ausnahme aus, wenn die angeforderte Ressource nicht gefunden wird (siehe XAML-Ressourcen).Searches for a Benutzeroberfläche (User Interface, UI)user interface (UI) resource, such as a Style or Brush, with the specified key, and throws an exception if the requested resource is not found (see XAML Resources).

GetContentStream(Uri) GetContentStream(Uri) GetContentStream(Uri) 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).Returns a resource stream for a content data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetCookie(Uri) GetCookie(Uri) GetCookie(Uri) GetCookie(Uri)

Ruft ein Cookie für den vom angegebenen Speicherort ab einem Uri.Retrieves a cookie for the location specified by a Uri.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetRemoteStream(Uri) GetRemoteStream(Uri) GetRemoteStream(Uri) 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).Returns a resource stream for a site-of-origin data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetResourceStream(Uri) GetResourceStream(Uri) GetResourceStream(Uri) 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).Returns a resource stream for a resource data file that is located at the specified Uri (see WPF Application Resource, Content, and Data Files).

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
LoadComponent(Object, Uri) LoadComponent(Object, Uri) LoadComponent(Object, Uri) LoadComponent(Object, Uri)

Lädt eine XAMLXAML-Datei, die sich unter dem angegebenen Uniform Resource Identifier (URI)uniform resource identifier (URI) befindet, und konvertiert sie in eine Instanz des Objekts, das durch das Stammelement der XAMLXAML-Datei angegeben wird.Loads a XAMLXAML file that is located at the specified Uniform Resource Identifier (URI)uniform resource identifier (URI) and converts it to an instance of the object that is specified by the root element of the XAMLXAML file.

LoadComponent(Uri) LoadComponent(Uri) LoadComponent(Uri) LoadComponent(Uri)

Lädt eine XAMLXAML -Datei, die sich am angegebenen Uniform Resource Identifier (URI)uniform resource identifier (URI), und konvertiert ihn in eine Instanz des Objekts, das durch das Stammelement der angegeben wird die XAMLXAML Datei.Loads a XAMLXAML file that is located at the specified Uniform Resource Identifier (URI)uniform resource identifier (URI), and converts it to an instance of the object that is specified by the root element of the XAMLXAML file.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnActivated(EventArgs) OnActivated(EventArgs) OnActivated(EventArgs) OnActivated(EventArgs)

Löst das Activated-Ereignis aus.Raises the Activated event.

OnDeactivated(EventArgs) OnDeactivated(EventArgs) OnDeactivated(EventArgs) OnDeactivated(EventArgs)

Löst das Deactivated-Ereignis aus.Raises the Deactivated event.

OnExit(ExitEventArgs) OnExit(ExitEventArgs) OnExit(ExitEventArgs) OnExit(ExitEventArgs)

Löst das Exit-Ereignis aus.Raises the Exit event.

OnFragmentNavigation(FragmentNavigationEventArgs) OnFragmentNavigation(FragmentNavigationEventArgs) OnFragmentNavigation(FragmentNavigationEventArgs) OnFragmentNavigation(FragmentNavigationEventArgs)

Löst das FragmentNavigation-Ereignis aus.Raises the FragmentNavigation event.

OnLoadCompleted(NavigationEventArgs) OnLoadCompleted(NavigationEventArgs) OnLoadCompleted(NavigationEventArgs) OnLoadCompleted(NavigationEventArgs)

Löst das LoadCompleted-Ereignis aus.Raises the LoadCompleted event.

OnNavigated(NavigationEventArgs) OnNavigated(NavigationEventArgs) OnNavigated(NavigationEventArgs) OnNavigated(NavigationEventArgs)

Löst das Navigated-Ereignis aus.Raises the Navigated event.

OnNavigating(NavigatingCancelEventArgs) OnNavigating(NavigatingCancelEventArgs) OnNavigating(NavigatingCancelEventArgs) OnNavigating(NavigatingCancelEventArgs)

Löst das Navigating-Ereignis aus.Raises the Navigating event.

OnNavigationFailed(NavigationFailedEventArgs) OnNavigationFailed(NavigationFailedEventArgs) OnNavigationFailed(NavigationFailedEventArgs) OnNavigationFailed(NavigationFailedEventArgs)

Löst das NavigationFailed-Ereignis aus.Raises the NavigationFailed event.

OnNavigationProgress(NavigationProgressEventArgs) OnNavigationProgress(NavigationProgressEventArgs) OnNavigationProgress(NavigationProgressEventArgs) OnNavigationProgress(NavigationProgressEventArgs)

Löst das NavigationProgress-Ereignis aus.Raises the NavigationProgress event.

OnNavigationStopped(NavigationEventArgs) OnNavigationStopped(NavigationEventArgs) OnNavigationStopped(NavigationEventArgs) OnNavigationStopped(NavigationEventArgs)

Löst das NavigationStopped-Ereignis aus.Raises the NavigationStopped event.

OnSessionEnding(SessionEndingCancelEventArgs) OnSessionEnding(SessionEndingCancelEventArgs) OnSessionEnding(SessionEndingCancelEventArgs) OnSessionEnding(SessionEndingCancelEventArgs)

Löst das SessionEnding-Ereignis aus.Raises the SessionEnding event.

OnStartup(StartupEventArgs) OnStartup(StartupEventArgs) OnStartup(StartupEventArgs) OnStartup(StartupEventArgs)

Löst das Startup-Ereignis aus.Raises the Startup event.

Run() Run() Run() Run()

Startet eine Windows Presentation Foundation-Anwendung.Starts a Windows Presentation Foundation application.

Run(Window) Run(Window) Run(Window) Run(Window)

Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster.Starts a Windows Presentation Foundation application and opens the specified window.

SetCookie(Uri, String) SetCookie(Uri, String) SetCookie(Uri, String) SetCookie(Uri, String)

Erstellt ein Cookie für den vom angegebenen Speicherort eine Uri.Creates a cookie for the location specified by a Uri.

Shutdown() Shutdown() Shutdown() Shutdown()

Fährt eine Anwendung ein.Shuts down an application.

Shutdown(Int32) Shutdown(Int32) Shutdown(Int32) Shutdown(Int32)

Fährt eine Anwendung, die den angegebenen Exitcode an das Betriebssystem zurückgibt.Shuts down an application that returns the specified exit code to the operating system.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TryFindResource(Object) TryFindResource(Object) TryFindResource(Object) TryFindResource(Object)

Sucht die angegebene Ressource.Searches for the specified resource.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Erzwingt, dass der aufrufende Thread den Zugriff auf diese DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Ereignisse

Activated Activated Activated Activated

Tritt auf, wenn eine Anwendung die vordergrundanwendung verwendet wird.Occurs when an application becomes the foreground application.

Deactivated Deactivated Deactivated Deactivated

Tritt auf, wenn eine Anwendung nicht mehr die vordergrundanwendung.Occurs when an application stops being the foreground application.

DispatcherUnhandledException DispatcherUnhandledException DispatcherUnhandledException DispatcherUnhandledException

Tritt auf, wenn eine Ausnahme ausgelöst, die von einer Anwendung, aber nicht behandelt.Occurs when an exception is thrown by an application but not handled.

Exit Exit Exit Exit

Tritt auf, kurz bevor eine Anwendung heruntergefahren und kann nicht abgebrochen werden.Occurs just before an application shuts down, and cannot be canceled.

FragmentNavigation FragmentNavigation FragmentNavigation FragmentNavigation

Tritt auf, wenn ein Navigator in der Anwendung der Navigation zu einem Inhaltsfragment beginnt Navigation erfolgt sofort, wenn das gewünschte Fragment im aktuellen Inhalt befindet oder nachdem die ist XAMLXAML -Quellinhalt geladen wurde, ist das gewünschte Fragment in verschiedenen Inhalt.Occurs when a navigator in the application begins navigation to a content fragment, Navigation occurs immediately if the desired fragment is in the current content, or after the source XAMLXAML content has been loaded if the desired fragment is in different content.

LoadCompleted LoadCompleted LoadCompleted LoadCompleted

Tritt auf, wenn der Inhalt, zu der navigiert wurde, von einem Navigator in der Anwendung, geladen wurde, analysiert, und mit dem Rendering begonnen wurde.Occurs when content that was navigated to by a navigator in the application has been loaded, parsed, and has begun rendering.

Navigated Navigated Navigated Navigated

Tritt auf, wenn Sie der Inhalt, der zu dem ein Navigator in der Anwendung navigiert wird gefunden wurde, auch wenn es nicht geladen wurde.Occurs when the content that is being navigated to by a navigator in the application has been found, although it may not have completed loading.

Navigating Navigating Navigating Navigating

Tritt auf, wenn von einem Navigator in der Anwendung eine neue Navigation angefordert wird.Occurs when a new navigation is requested by a navigator in the application.

NavigationFailed NavigationFailed NavigationFailed NavigationFailed

Tritt auf, wenn ein Fehler auftritt, während ein Navigator in der Anwendung zum angeforderten Inhalt navigiert wird.Occurs when an error occurs while a navigator in the application is navigating to the requested content.

NavigationProgress NavigationProgress NavigationProgress NavigationProgress

Tritt auf, in regelmäßigen Abständen während eines Downloadvorgangs auf, das von einem Navigator in der Anwendung zum Bereitstellen von Statusinformationen für die Navigation verwaltet wird.Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information.

NavigationStopped NavigationStopped NavigationStopped NavigationStopped

Tritt auf, wenn die StopLoading eines Navigators in der Anwendung aufgerufen, oder wenn eine neue Navigation angefordert wird, von einem Navigator während eine aktuelle Navigation noch ausgeführt wird.Occurs when the StopLoading method of a navigator in the application is called, or when a new navigation is requested by a navigator while a current navigation is in progress.

SessionEnding SessionEnding SessionEnding SessionEnding

Tritt ein, wenn ein Benutzer die Windows-Sitzung beendet, indem er sich abmeldet oder das Betriebssystem herunterfährt.Occurs when the user ends the Windows session by logging off or shutting down the operating system.

Startup Startup Startup Startup

Tritt auf, wenn die Run() Methode der Application -Objekts aufgerufen wird.Occurs when the Run() method of the Application object is called.

Explizite Schnittstellenimplementierungen

IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String)

Fragt ab, ob eine angegebene Ambiente-Eigenschaft im aktuellen Bereich verfügbar ist.Queries for whether a specified ambient property is available in the current scope.

Gilt für:

Threadsicherheit

Die öffentliche static (Shared in Visual Basic) Member dieses Typs sind threadsicher.The public static (Shared in Visual Basic) members of this type are thread safe. Darüber hinaus die FindResource(Object) und TryFindResource(Object) Methoden und die Properties und Resources Eigenschaften sind threadsicher.In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.

Siehe auch