Язык

Application Класс

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

Представляет текущее приложение и его доступные службы.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Комментарии

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

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

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

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

Tip

Дополнительные сведения см. в разделе Windows App SDK жизненном цикле приложений.

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

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

Note

Основной Application файл должен быть назван App.xaml.

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

Имя Описание
Application()

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

Свойства

Имя Описание
Current

Возвращает объект Application для текущего приложения.
DebugSettings

Возвращает объект, который объявляет, как работает приложение при запуске в среде отладки.
DispatcherShutdownMode

Возвращает или задает значение, указывающее, завершается ли цикл событий DispatcherQueue при закрытии всех окон XAML в потоке.
FocusVisualKind

Возвращает или задает тип визуальной обратной связи, который приложение может использовать для указания элемента пользовательского интерфейса с фокусом.
HighContrastAdjustment

Возвращает или задает значение, указывающее, автоматически ли платформа настраивает визуальные свойства при включении тем высокой контрастности.
RequestedTheme

Возвращает или задает значение, определяющее светло-темные предпочтения для общей темы приложения.
Resources

Возвращает коллекцию ресурсов с областью применения, таких как стили, шаблоны и кисти.

Методы

Имя Описание
Exit()

Завершает работу приложения.
LoadComponent(Object, Uri, ComponentResourceLocation)

Загружает XAML-файл, расположенный в указанном относительном расположении, и преобразует его в экземпляр объекта, указанного корневым элементом XAML-файла.
LoadComponent(Object, Uri)

Загружает XAML-файл, расположенный в указанном относительном расположении, и преобразует его в экземпляр объекта, указанного корневым элементом XAML-файла.
OnLaunched(LaunchActivatedEventArgs)

Вызывается при запуске приложения. Переопределите этот метод для выполнения инициализации приложения и создания нового окна.
Start(ApplicationInitializationCallback)

Предоставляет точку входа и запросы инициализации приложения. Используйте указанный объект ApplicationInitializationCallback , чтобы создать экземпляр класса Application .

События

Имя Описание
ResourceManagerRequested

Происходит во время запуска нового потока WinUI, чтобы предоставить пользовательскую IResourceManager реализацию, используемую платформой для разрешения URI ресурсов.
UnhandledException

Возникает, когда исключение может обрабатываться кодом приложения, как пересылается из ошибки среда выполнения Windows на собственном уровне. Приложения могут пометить вхождение как обработанное в данных события.

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

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