Application Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Encapsulates a Windows Presentation Foundation application.
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
- Inheritance
- Implements
Examples
The following example shows how a standard application is defined using only markup:
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
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 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
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 System.Windows
Namespace SDKSample
Partial Public Class App
Inherits Application
End Class
End Namespace
Remarks
Application is a class that encapsulates WPF application-specific functionality, including the following:
Application Lifetime: Activated, Current, Deactivated, DispatcherUnhandledException, Exit, Run, SessionEnding, Shutdown, ShutdownMode, Startup.
Application-Scope Window, Property, and Resource Management: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, StartupUri, Windows.
Command-Line Parameter and Exit Code Processing: Application.Startup, Application.Exit, Application.Shutdown.
Navigation: FragmentNavigation, LoadCompleted, Navigated, Navigating, NavigationProgress, NavigationStopped, NavigationFailed, SetCookie, GetCookie.
Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. Consequently, only one instance of the Application class can be created per AppDomain.
You can implement an Application using markup, markup and code-behind, or code. 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) ApplicationDefinition
item.
Note
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. However, XAML browser applications (XBAPs) require an Application object.
Constructors
Application() |
Initializes a new instance of the Application class. |
Properties
Current |
Gets the Application object for the current AppDomain. |
Dispatcher |
Gets the Dispatcher this DispatcherObject is associated with. (Inherited from DispatcherObject) |
MainWindow |
Gets or sets the main window of the application. |
Properties |
Gets a collection of application-scope properties. |
ResourceAssembly |
Gets or sets the Assembly that provides the pack uniform resource identifiers (URIs) for resources in a WPF application. |
Resources |
Gets or sets a collection of application-scope resources, such as styles and brushes. |
ShutdownMode |
Gets or sets the condition that causes the Shutdown() method to be called. |
StartupUri |
Gets or sets a UI that is automatically shown when an application starts. |
ThemeMode | |
Windows |
Gets the instantiated windows in an application. |
Methods
CheckAccess() |
Determines whether the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject) |
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
FindResource(Object) |
Searches for a 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) |
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) |
Retrieves a cookie for the location specified by a Uri. |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
GetRemoteStream(Uri) |
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) |
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() |
Gets the Type of the current instance. (Inherited from Object) |
LoadComponent(Object, Uri) |
Loads a XAML file that is located at the specified uniform resource identifier (URI) and converts it to an instance of the object that is specified by the root element of the XAML file. |
LoadComponent(Uri) |
Loads a XAML file that is located at the specified uniform resource identifier (URI), and converts it to an instance of the object that is specified by the root element of the XAML file. |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
OnActivated(EventArgs) |
Raises the Activated event. |
OnDeactivated(EventArgs) |
Raises the Deactivated event. |
OnExit(ExitEventArgs) |
Raises the Exit event. |
OnFragmentNavigation(FragmentNavigationEventArgs) |
Raises the FragmentNavigation event. |
OnLoadCompleted(NavigationEventArgs) |
Raises the LoadCompleted event. |
OnNavigated(NavigationEventArgs) |
Raises the Navigated event. |
OnNavigating(NavigatingCancelEventArgs) |
Raises the Navigating event. |
OnNavigationFailed(NavigationFailedEventArgs) |
Raises the NavigationFailed event. |
OnNavigationProgress(NavigationProgressEventArgs) |
Raises the NavigationProgress event. |
OnNavigationStopped(NavigationEventArgs) |
Raises the NavigationStopped event. |
OnSessionEnding(SessionEndingCancelEventArgs) |
Raises the SessionEnding event. |
OnStartup(StartupEventArgs) |
Raises the Startup event. |
Run() |
Starts a Windows Presentation Foundation application. |
Run(Window) |
Starts a Windows Presentation Foundation application and opens the specified window. |
SetCookie(Uri, String) |
Creates a cookie for the location specified by a Uri. |
Shutdown() |
Shuts down an application. |
Shutdown(Int32) |
Shuts down an application that returns the specified exit code to the operating system. |
ToString() |
Returns a string that represents the current object. (Inherited from Object) |
TryFindResource(Object) |
Searches for the specified resource. |
VerifyAccess() |
Enforces that the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject) |
Events
Activated |
Occurs when an application becomes the foreground application. |
Deactivated |
Occurs when an application stops being the foreground application. |
DispatcherUnhandledException |
Occurs when an exception is thrown by an application but not handled. |
Exit |
Occurs just before an application shuts down and cannot be canceled. |
FragmentNavigation |
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 XAML content has been loaded if the desired fragment is in different content. |
LoadCompleted |
Occurs when content that was navigated to by a navigator in the application has been loaded, parsed, and has begun rendering. |
Navigated |
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 |
Occurs when a new navigation is requested by a navigator in the application. |
NavigationFailed |
Occurs when an error occurs while a navigator in the application is navigating to the requested content. |
NavigationProgress |
Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information. |
NavigationStopped |
Occurs when the |
SessionEnding |
Occurs when the user ends the Windows session by logging off or shutting down the operating system. |
Startup |
Occurs when the Run() method of the Application object is called. |
Explicit Interface Implementations
IQueryAmbient.IsAmbientPropertyAvailable(String) |
Queries for whether a specified ambient property is available in the current scope. |
Applies to
Thread Safety
The public static
(Shared
in Visual Basic) members of this type are thread safe. In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.
See also
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για