Application Application Application Application Class

Определение

Инкапсулирует приложение Windows Presentation Foundation.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
Наследование
Реализации

Примеры

В следующем примере показано, как стандартное приложение — с использованием одной разметки: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 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

В следующем примере показано, как стандартное приложение — с использованием комбинации разметки и кода.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

Комментарии

Application — Это класс, который инкапсулирует WPFWPF функции для конкретных приложений, включая следующие:Application is a class that encapsulates WPFWPF application-specific functionality, including the following:

Application реализует шаблон с одним элементом для предоставления общего доступа к его окна и свойств службы области ресурсов.Application implements the singleton pattern to provide shared access to its window, property, and resource scope services. Следовательно, только один экземпляр Application класс можно создать на AppDomain.Consequently, only one instance of the Application class can be created per AppDomain.

Вы можете реализовать Application с помощью разметки, разметки и кода или кода.You can implement an Application using markup, markup and code-behind, or code. Если Application реализуется с помощью разметки, ли разметки или разметки и кода, размеченный файл должен быть настроен как Microsoft Build Engine (MSBuild)Microsoft build engine (MSBuild) ApplicationDefinition элемента.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.

Примечание

Автономное приложение не требует Application объекта; это можно реализовать пользовательский static метод точки входа (Main), открывает окно без создания экземпляра 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. Тем не менее XAML-приложения браузера (XBAP)XAML browser applications (XBAPs) требуют Application объекта.However, XAML-приложения браузера (XBAP)XAML browser applications (XBAPs) require an Application object.

Конструкторы

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

Инициализирует новый экземпляр класса Application.Initializes a new instance of the Application class.

Свойства

Current Current Current Current

Возвращает объект Application текущего AppDomain.Gets the Application object for the current AppDomain.

Dispatcher Dispatcher Dispatcher Dispatcher

Получает Dispatcher это DispatcherObject связан.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
MainWindow MainWindow MainWindow MainWindow

Получает или задает главное окно приложения.Gets or sets the main window of the application.

Properties Properties Properties Properties

Возвращает коллекцию свойств области приложения.Gets a collection of application-scope properties.

ResourceAssembly ResourceAssembly ResourceAssembly ResourceAssembly

Получает или задает Assembly, обеспечивающий набор универсальные идентификаторы ресурсов (URI)uniform resource identifiers (URIs) для ресурсов приложения WPFWPF.Gets or sets the Assembly that provides the pack универсальные идентификаторы ресурсов (URI)uniform resource identifiers (URIs) for resources in a WPFWPF application.

Resources Resources Resources Resources

Получает или задает коллекцию ресурсов области приложения, например, стилей и кистей.Gets or sets a collection of application-scope resources, such as styles and brushes.

ShutdownMode ShutdownMode ShutdownMode ShutdownMode

Получает или задает условие, которое является причиной вызова метода Shutdown().Gets or sets the condition that causes the Shutdown() method to be called.

StartupUri StartupUri StartupUri StartupUri

Получает или задает пользовательский интерфейс, отображающееся автоматически при запуске приложения.Gets or sets a UI that is automatically shown when an application starts.

Windows Windows Windows Windows

Возвращает созданные окна приложения.Gets the instantiated windows in an application.

Методы

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

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

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

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Осуществляет поиск ресурса пользовательский интерфейсuser interface (UI), например Style или Brush, с указанным ключом и генерирует исключение, если запрошенный ресурс не найден (см. Ресурсы XAML).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) GetContentStream(Uri) GetContentStream(Uri) GetContentStream(Uri)

Возвращает поток ресурса для файла данных содержания, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).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)

Возвращает файл cookie для расположения, указанного Uri.Retrieves a cookie for the location specified by a Uri.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetRemoteStream(Uri) GetRemoteStream(Uri) GetRemoteStream(Uri) GetRemoteStream(Uri)

Возвращает поток ресурса для исходного файла данных ресурса, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).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)

Возвращает поток ресурса для файла данных ресурса, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).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()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Загружает файл XAMLXAML, расположенный в указанном универсальный идентификатор ресурса (URI)uniform resource identifier (URI), и преобразует его в экземпляр объекта, заданного корневым элементом файла XAMLXAML.Loads a XAMLXAML file that is located at the specified универсальный идентификатор ресурса (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)

Подгружает файл XAMLXAML, располагающийся по указанному универсальный идентификатор ресурса (URI)uniform resource identifier (URI), и преобразует его в экземпляр объекта, определенного корневым элементом файла XAMLXAML.Loads a XAMLXAML file that is located at the specified универсальный идентификатор ресурса (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()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Создает событие Activated.Raises the Activated event.

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

Создает событие Deactivated.Raises the Deactivated event.

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

Создает событие Exit.Raises the Exit event.

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

Создает событие FragmentNavigation.Raises the FragmentNavigation event.

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

Создает событие LoadCompleted.Raises the LoadCompleted event.

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

Создает событие Navigated.Raises the Navigated event.

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

Создает событие Navigating.Raises the Navigating event.

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

Создает событие NavigationFailed.Raises the NavigationFailed event.

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

Создает событие NavigationProgress.Raises the NavigationProgress event.

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

Создает событие NavigationStopped.Raises the NavigationStopped event.

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

Создает событие SessionEnding.Raises the SessionEnding event.

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

Создает событие Startup.Raises the Startup event.

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

Запускает приложение Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

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

Запускает приложение Windows Presentation Foundation с открытием указанного окна.Starts a Windows Presentation Foundation application and opens the specified window.

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

Создает файл cookie для расположения, указанного Uri.Creates a cookie for the location specified by a Uri.

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

Завершить работу приложения.Shuts down an application.

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

Завершает работу приложения и передает указанный код завершения операционной системой.Shuts down an application that returns the specified exit code to the operating system.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

Осуществляет поиск указанного ресурса.Searches for the specified resource.

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

Обеспечивает, что вызывающий поток имеет доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

События

Activated Activated Activated Activated

Происходит, когда приложение становиться активным.Occurs when an application becomes the foreground application.

Deactivated Deactivated Deactivated Deactivated

Происходит, когда приложение перестает быть активным.Occurs when an application stops being the foreground application.

DispatcherUnhandledException DispatcherUnhandledException DispatcherUnhandledException DispatcherUnhandledException

Происходит при генерации приложением исключения, которое не обрабатывается.Occurs when an exception is thrown by an application but not handled.

Exit Exit Exit Exit

Генерируется непосредственно перед завершением работы приложения и не может быть отменено.Occurs just before an application shuts down, and cannot be canceled.

FragmentNavigation FragmentNavigation FragmentNavigation FragmentNavigation

Происходит, когда начинается переход к фрагменту содержимого, Переход происходит сразу же, если желаемый фрагмент находится в текущем содержимом, или после загрузки исходного содержимого XAMLXAML, если желаемый фрагмент находится в другом содержимом.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

Происходит после того, как содержимое, переданное приложению, было загружено, проанализировано и отрисовывается.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

Происходит, когда содержимое, к которому осуществляется переход, найдено, хотя его загрузка, возможно, еще не завершена.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

Происходит при запросе приложением перехода.Occurs when a new navigation is requested by a navigator in the application.

NavigationFailed NavigationFailed NavigationFailed NavigationFailed

Происходит, когда происходит ошибка при переходе к указанному содержимому.Occurs when an error occurs while a navigator in the application is navigating to the requested content.

NavigationProgress NavigationProgress NavigationProgress NavigationProgress

Происходит время от времени во время загрузки, управляемой приложением для предоставления информации о статусе загрузки.Occurs periodically during a download that is being managed by a navigator in the application to provide navigation progress information.

NavigationStopped NavigationStopped NavigationStopped NavigationStopped

Появляется при вызове метода перехода приложения StopLoading, или когда поступил запрос нового перехода во время выполнения текущего.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

Происходит, когда пользователь завершает сеанс Windows, выходя из системы или завершая работу операционной системы.Occurs when the user ends the Windows session by logging off or shutting down the operating system.

Startup Startup Startup Startup

Происходит при вызове метода Run() объекта Application.Occurs when the Run() method of the Application object is called.

Явные реализации интерфейса

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

Запрашивает, доступно ли заданное внешнее свойство в текущей области.Queries for whether a specified ambient property is available in the current scope.

Применяется к

Потокобезопасность

Открытый static (Shared в Visual Basic) члены этого типа являются потокобезопасными.The public static (Shared in Visual Basic) members of this type are thread safe. Кроме того FindResource(Object) и TryFindResource(Object) методы и Properties и Resources свойства являются потокобезопасными.In addition, the FindResource(Object) and TryFindResource(Object) methods and the Properties and Resources properties are thread safe.

Дополнительно