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 일반적으로 App.xaml에 대한 초기 XAML에서 제공됩니다. Visual Studio의 기본 프로젝트 템플릿은 에서 Application 파생되는 클래스를 App 생성하고 초기화 코드를 추가할 수 있는 진입점을 제공합니다.

클래스는 App 생성자에서 생성된 InitializeComponent 메서드를 호출하여 해당 XAML에 자신을 연결합니다. 생성자에 추가 초기화 코드를 App 추가할 수 있지만 일반적으로 UnhandledException 이벤트에 대한 처리기를 연결하거나 RequestedTheme을 설정하는 코드만 추가합니다. OnLaunched 메서드 재정의에 다른 초기화 코드를 배치해야 합니다.

팁

자세한 내용은 Windows 앱 SDK 앱 수명 주기를 참조하세요.

애플리케이션 모델, codegen 및 활성화 시퀀스의 Application 위치 때문에 XAML 사용에 대한 몇 가지 제한 사항이 있습니다.

• xmlns 선언 및 x:Class 이외의 다른 특성은 루트 태그에 표시할 Application 수 없습니다.
• 프로젝트 템플릿 App.xaml 페이지에서 제공되는 x:Class 값을 변경하지 마세요. 빌드 작업에 있는 명명 체계를 사용하는 방법에 대한 추가 종속성이 있습니다.
• XAML에서 Application 이벤트 처리기를 연결하지 마세요. 모든 이벤트 배선은 코드(일반적으로 생성자)에서 수행해야 합니다.
• XAML의 instance 예상되는 속성은 XAML 속성 Application 요소 사용을 사용하여 Application.Resources 속성을 채우는 요소 집합입니다. 자세한 내용은 리소스를 참조하세요.
• 앱 코드에서 catch하지 않는 예외에 대한 일반적인 오류 처리를 제공하려면 UnhandledException 이벤트를 처리합니다.

참고

기본 파일의 Application 이름은 App.xaml여야 합니다.

생성자

Application()

Application 클래스의 새 instance 초기화합니다.

속성

Current	현재 애플리케이션의 Application 개체를 가져옵니다.
DebugSettings	디버그 환경에서 실행할 때 앱이 작동하는 방식을 선언하는 개체를 가져옵니다.
DispatcherShutdownMode	스레드의 모든 XAML 창이 닫혀 있을 때 DispatcherQueue 이벤트 루프가 종료되는지 여부를 지정하는 값을 가져오거나 설정합니다.
FocusVisualKind	앱이 포커스가 있는 UI 요소를 나타내는 데 사용할 수 있는 시각적 피드백 유형을 가져오거나 설정합니다.
HighContrastAdjustment	고대비 테마를 사용할 때 프레임워크가 시각적 속성을 자동으로 조정하는지 여부를 나타내는 값을 가져오거나 설정합니다.
RequestedTheme	앱의 전체 테마에 대한 밝은 어두운 기본 설정을 결정하는 값을 가져오거나 설정합니다.
Resources	스타일, 템플릿 및 브러시와 같은 애플리케이션 범위 리소스의 컬렉션을 가져옵니다.

메서드

Exit()	앱을 종료합니다.
LoadComponent(Object, Uri)	지정된 상대 위치에 있는 XAML 파일을 로드하고 XAML 파일의 루트 요소로 지정된 개체의 instance 변환합니다.
LoadComponent(Object, Uri, ComponentResourceLocation)	지정된 상대 위치에 있는 XAML 파일을 로드하고 XAML 파일의 루트 요소로 지정된 개체의 instance 변환합니다.
OnLaunched(LaunchActivatedEventArgs)	애플리케이션이 시작될 때 호출됩니다. 애플리케이션 초기화를 수행하고 새 창을 만들려면 이 메서드를 재정의합니다.
Start(ApplicationInitializationCallback)	진입점을 제공하고 애플리케이션의 초기화를 요청합니다. 지정된 ApplicationInitializationCallback 을 사용하여 Application 클래스를 인스턴스화합니다.

이벤트

ResourceManagerRequested	리소스 URI를 확인하기 위해 프레임워크에서 사용할 사용자 지정 IResourceManager 구현을 제공할 수 있도록 새 WinUI 스레드를 시작하는 동안 발생합니다.
UnhandledException	네이티브 수준 Windows 런타임 오류에서 전달된 대로 앱 코드에서 예외를 처리할 수 있는 경우에 발생합니다. 앱은 이벤트 데이터에서 발생을 처리됨으로 표시할 수 있습니다.

추가 정보

• Window
• Windows 앱 SDK 앱 수명 주기