Application Класс

Определение

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

Windows.UI.Xaml

Инкапсулирует приложение и доступные службы.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application

Public Class Application

<Application />
 

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

Object IInspectable Application

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Класс Application инкапсулирует приложение и предоставляет следующие службы:

• точка входа в приложение, особенно для различных контрактов активации
• управление временем существования приложений
• Ресурсы с областью приложения
• обнаружение необработанных исключений

Объект Application обычно предоставляется в исходном коде XAML для App.xaml. Шаблоны проектов по умолчанию в Visual Studio создают класс, производный App от Application и предоставляющий точку входа, в которую можно добавить код инициализации.

Класс App связывает себя с соответствующим XAML путем вызова созданного InitializeComponent метода в его конструкторе. В конструктор можно добавить дополнительный App код инициализации, но обычно код добавляется только для связывания обработчиков с событиями приложения. Для другого кода инициализации следует переопределить один или несколько методов инициализации, таких как OnLaunched.

Система обрабатывает время существования приложения, приостанавливая его всякий раз, когда пользователь переключается на другое приложение или на рабочий стол, и возобновляя работу приложения всякий раз, когда пользователь переключается на него. Однако система также может завершить работу приложения, пока оно приостановлено, чтобы освободить ресурсы. Необходимо обработать событие Suspending , чтобы сохранить состояние приложения в случае завершения, и переопределить метод OnLaunched для восстановления состояния приложения. Событие возобновления следует обрабатывать только в том случае, если необходимо обновить отображаемое содержимое, которое могло измениться во время приостановки приложения. Вам не нужно восстанавливать другое состояние приложения при возобновлении работы приложения.

В связи с положением в модели приложения, codegen и последовательности активации приложение имеет некоторые ограничения на использование XAML:

• Кроме объявлений xmlns и x:Class, другие атрибуты не могут отображаться в корневом теге Application .
• Не пытайтесь изменить значения x:Class , полученные на страницах шаблона проекта App.xaml. Существуют дополнительные зависимости от использования этой схемы именования, которые существуют в действиях сборки.
• Не завязывайте обработчики событий приложения в XAML. Все подключения событий должны выполняться в коде (обычно в конструкторе). Кроме того, для события обычно используются переопределения методов, а не синтаксис событий (например, переопределяется OnActivated для реагирования на этот этап жизненного цикла приложения).
• Единственными ожидаемыми свойствами экземпляра приложения в XAML является набор элементов для заполнения свойства Application.Resources с использованием элемента свойства XAML. Дополнительные сведения см. в разделе Ресурсы. Чтобы обеспечить общую обработку ошибок для всех исключений, которые код приложения не перехватывает, обработайте событие UnhandledException .

Примечание

Файл main приложения должен иметь имя App.xaml.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RequiresPointerMode
1703	15063	HighContrastAdjustment

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

Application()

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

Свойства

Current	Возвращает объект Application для текущего приложения.
DebugSettings	Возвращает объект , объявляющий поведение приложения при запуске в среде отладки.
FocusVisualKind	Возвращает или задает тип визуальной обратной связи, которую приложение может использовать для указания элемента пользовательского интерфейса с фокусом. Это свойство допустимо только для устройств ввода, которые могут создавать события клавиш, например клавиатуры или игровой панели.
HighContrastAdjustment	Возвращает или задает значение, указывающее, настраивает ли платформа автоматически свойства визуальных элементов при включении тем с высокой контрастностью.
RequestedTheme	Возвращает или задает значение, определяющее светло-темные предпочтения для общей темы приложения.
RequiresPointerMode	Возвращает или задает значение, указывающее, поддерживает ли приложение UWP режим мыши, который эмулирует взаимодействие с указателями с устройствами ввода без указателя, такими как игровая площадка или удаленное управление. (Все вложенные элементы наследуют это поведение.)
Resources	Возвращает коллекцию ресурсов области приложения, таких как стили, шаблоны и кисти.

Методы

Exit()	Завершает работу приложения.
LoadComponent(Object, Uri, ComponentResourceLocation)	Загружает XAML-файл, расположенный в указанном относительном расположении, и преобразует его в экземпляр объекта, указанного корневым элементом ФАЙЛА XAML.
LoadComponent(Object, Uri)	Загружает XAML-файл, расположенный в указанном относительном расположении, и преобразует его в экземпляр объекта, указанного корневым элементом ФАЙЛА XAML.
OnActivated(IActivatedEventArgs)	Вызывается при активации приложения с помощью некоторых средств, отличных от обычного запуска.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Вызывается при активации приложения в фоновом режиме.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Вызывается при активации приложения из-за контракта активации с параметром ActivationKind в качестве CachedFileUpdater.
OnFileActivated(FileActivatedEventArgs)	Вызывается при активации приложения с помощью открытия файла.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Вызывается при активации приложения с помощью связи диалогового окна открытия файла.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Вызывается при активации приложения с помощью связи диалогового окна сохранения файла.
OnLaunched(LaunchActivatedEventArgs)	Вызывается при запуске приложения. Переопределите этот метод, чтобы выполнить инициализацию приложения и отобразить начальное содержимое в связанном окне.
OnSearchActivated(SearchActivatedEventArgs)	Вызывается при активации приложения с помощью сопоставления поиска.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Вызывается при активации приложения с помощью связи общего доступа.
OnWindowCreated(WindowCreatedEventArgs)	Вызывается, когда приложение создает окно.
Start(ApplicationInitializationCallback)	Предоставляет точку входа и инициализацию приложения. Используйте обратный вызов для создания экземпляра класса Application .

События

EnteredBackground	Происходит при перемещении приложения с переднего плана на фон.
LeavingBackground	Происходит при перемещении приложения с фона на передний план.
Resuming	Происходит при переходе приложения из состояния "Приостановлено" в состояние "Выполняется".
Suspending	Происходит при переходе приложения в состояние Приостановлено из другого состояния.
UnhandledException	Возникает, когда исключение может быть обработано кодом приложения, переадресованным из ошибки среда выполнения Windows машинного уровня. Приложения могут помечать событие как обработанное в данных события.

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

• Window
• Обработка активации приложения
• Обработка приостановки работы приложения
• Обработка возобновления работы приложения