Application Класс

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Инкапсулирует приложение Windows Presentation Foundation.

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

Наследование

Object

DispatcherObject

Application

Реализации

IQueryAmbient

Примеры

В следующем примере показано, как стандартное приложение определяется с помощью только разметки:

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

В следующем примере показано, как стандартное приложение определяется с помощью только кода:

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

В следующем примере показано, как стандартное приложение определяется с помощью сочетания разметки и кода программной части.

<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

Комментарии

Application — это класс, который инкапсулирует функциональные возможности приложений WPF, включая следующие:

• Время существования приложения: Activated, Current, Deactivated, ExitDispatcherUnhandledException, Run, SessionEnding, , Shutdown, , ShutdownMode, . Startup

• Окно, свойство и управление ресурсами области приложения: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, , Properties, Resources, , StartupUri. Windows

• Параметр командной строки и обработка кода выхода: Application.Startup, Application.Exit, Application.Shutdown.

• Навигация: FragmentNavigation, LoadCompleted, Navigated, NavigationProgressNavigating, NavigationStopped, NavigationFailed, , SetCookie. GetCookie

Application реализует одноэлементный шаблон для предоставления общего доступа к своим службам окон, свойств и ресурсов. Следовательно, для каждого AppDomainможно создать только один экземпляр Application класса .

Вы можете реализовать с помощью разметки Application , разметки и кода программной части или кода. Если Application реализована разметка, будь то разметка или разметка и код программной части, файл разметки должен быть настроен как элемент microsoft build engine (MSBuild). ApplicationDefinition

Примечание

Автономному приложению не требуется Application объект ; можно реализовать настраиваемый static метод точки входа (Main), который открывает окно без создания экземпляра Application. Однако для браузерных приложений XAML (XBAP) требуется Application объект .

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

Application()

Инициализирует новый экземпляр класса Application.

Свойства

Current	Возвращает объект Application для текущего AppDomain.
Dispatcher	Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. (Унаследовано от DispatcherObject)
MainWindow	Получает или задает главное окно приложения.
Properties	Возвращает коллекцию свойств области приложения.
ResourceAssembly	Возвращает или задает Assembly объект , предоставляющий универсальные идентификаторы ресурсов (URI) пакета для ресурсов в приложении WPF.
Resources	Получает или задает коллекцию ресурсов области приложения, например, стилей и кистей.
ShutdownMode	Получает или задает условие, которое является причиной вызова метода Shutdown().
StartupUri	Получает или задает пользовательский интерфейс, отображающееся автоматически при запуске приложения.
Windows	Возвращает созданные окна приложения.

Методы

CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindResource(Object)	Выполняет поиск ресурса пользовательского интерфейса, например Style или Brush, с указанным ключом, и создает исключение, если запрошенный ресурс не найден (см. раздел Ресурсы XAML).
GetContentStream(Uri)	Возвращает поток ресурса для файла данных содержания, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).
GetCookie(Uri)	Возвращает файл cookie для расположения, указанного Uri.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRemoteStream(Uri)	Возвращает поток ресурса для исходного файла данных ресурса, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).
GetResourceStream(Uri)	Возвращает поток ресурса для файла данных ресурса, расположенного в указанном Uri (см. Ресурсы, содержимое и файлы данных WPF-приложения).
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
LoadComponent(Object, Uri)	Загружает XAML-файл, расположенный по указанному универсальному коду ресурса (URI), и преобразует его в экземпляр объекта , указанного корневым элементом XAML-файла.
LoadComponent(Uri)	Загружает XAML-файл, расположенный по указанному универсальному коду ресурса (URI), и преобразует его в экземпляр объекта, указанного корневым элементом ФАЙЛА XAML.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnActivated(EventArgs)	Вызывает событие Activated.
OnDeactivated(EventArgs)	Вызывает событие Deactivated.
OnExit(ExitEventArgs)	Вызывает событие Exit.
OnFragmentNavigation(FragmentNavigationEventArgs)	Вызывает событие FragmentNavigation.
OnLoadCompleted(NavigationEventArgs)	Вызывает событие LoadCompleted.
OnNavigated(NavigationEventArgs)	Вызывает событие Navigated.
OnNavigating(NavigatingCancelEventArgs)	Вызывает событие Navigating.
OnNavigationFailed(NavigationFailedEventArgs)	Вызывает событие NavigationFailed.
OnNavigationProgress(NavigationProgressEventArgs)	Вызывает событие NavigationProgress.
OnNavigationStopped(NavigationEventArgs)	Вызывает событие NavigationStopped.
OnSessionEnding(SessionEndingCancelEventArgs)	Вызывает событие SessionEnding.
OnStartup(StartupEventArgs)	Вызывает событие Startup.
Run()	Запускает приложение Windows Presentation Foundation.
Run(Window)	Запускает приложение Windows Presentation Foundation с открытием указанного окна.
SetCookie(Uri, String)	Создает файл cookie для расположения, указанного Uri.
Shutdown()	Завершить работу приложения.
Shutdown(Int32)	Завершает работу приложения и передает указанный код завершения операционной системой.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TryFindResource(Object)	Осуществляет поиск указанного ресурса.
VerifyAccess()	Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)

События

Activated	Происходит, когда приложение становиться активным.
Deactivated	Происходит, когда приложение перестает быть активным.
DispatcherUnhandledException	Происходит при генерации приложением исключения, которое не обрабатывается.
Exit	Происходит непосредственно перед завершением работы приложения и не может быть отменена.
FragmentNavigation	Происходит, когда навигатор в приложении начинает переход к фрагменту содержимого. Навигация происходит немедленно, если нужный фрагмент находится в текущем содержимом, или после загрузки исходного содержимого XAML, если нужный фрагмент находится в другом содержимом.
LoadCompleted	Происходит после того, как содержимое, переданное приложению, было загружено, проанализировано и отрисовывается.
Navigated	Происходит, когда содержимое, к которому осуществляется переход, найдено, хотя его загрузка, возможно, еще не завершена.
Navigating	Происходит при запросе приложением перехода.
NavigationFailed	Происходит, когда происходит ошибка при переходе к указанному содержимому.
NavigationProgress	Происходит время от времени во время загрузки, управляемой приложением для предоставления информации о статусе загрузки.
NavigationStopped	Появляется при вызове метода перехода приложения StopLoading, или когда поступил запрос нового перехода во время выполнения текущего.
SessionEnding	Происходит, когда пользователь завершает сеанс Windows, выходя из системы или завершая работу операционной системы.
Startup	Происходит при вызове метода Run() объекта Application.

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

IQueryAmbient.IsAmbientPropertyAvailable(String)

Запрашивает, доступно ли заданное внешнее свойство в текущей области.

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

Открытые static члены (Shared в Visual Basic) этого типа являются потокобезопасны. Кроме того, методы FindResource(Object) и TryFindResource(Object) и Properties свойства и Resources являются потокобезопасны.

См. также раздел

• Window