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 или задать RequestedTheme. Следует поместить другой код инициализации в переопределение метода OnLaunched .

Совет

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

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

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

Примечание

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

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

Application()

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

Свойства

Current

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

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

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

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

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

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

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

Методы

Exit()

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

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

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

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

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

События

ResourceManagerRequested

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

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

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

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