Application 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 애플리케이션 및 사용 가능한 서비스를 나타냅니다.
/// [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 />
- 상속
- 특성
설명
클래스는 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, ComponentResourceLocation) |
지정된 상대 위치에 있는 XAML 파일을 로드하고 XAML 파일의 루트 요소로 지정된 개체의 instance 변환합니다. |
LoadComponent(Object, Uri) |
지정된 상대 위치에 있는 XAML 파일을 로드하고 XAML 파일의 루트 요소로 지정된 개체의 instance 변환합니다. |
OnLaunched(LaunchActivatedEventArgs) |
애플리케이션이 시작될 때 호출됩니다. 애플리케이션 초기화를 수행하고 새 창을 만들려면 이 메서드를 재정의합니다. |
Start(ApplicationInitializationCallback) |
진입점을 제공하고 애플리케이션의 초기화를 요청합니다. 지정된 ApplicationInitializationCallback 을 사용하여 Application 클래스를 인스턴스화합니다. |
이벤트
ResourceManagerRequested |
리소스 URI를 확인하기 위해 프레임워크에서 사용할 사용자 지정 |
UnhandledException |
네이티브 수준 Windows 런타임 오류에서 전달된 대로 앱 코드에서 예외를 처리할 수 있는 경우에 발생합니다. 앱은 이벤트 데이터에서 발생을 처리됨으로 표시할 수 있습니다. |