Application 클래스

정의

현재 애플리케이션 및 사용 가능한 서비스를 나타냅니다.

/// [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 클래스는 앱을 캡슐화하고 다음 서비스를 제공합니다.

  • 앱 진입점, 특히 다양한 활성화 계약의 경우
  • 앱 수명 관리
  • 앱 범위 리소스
  • 처리되지 않은 예외 검색

Application 개체는 일반적으로 App.xaml에 대한 초기 XAML에서 제공됩니다. Visual Studio의 기본 프로젝트 템플릿은 애플리케이션에서 파생되는 클래스를 생성 App 하고 초기화 코드를 추가할 수 있는 진입점을 제공합니다.

클래스는 App 생성자에서 생성된 InitializeComponent 메서드를 호출하여 해당 XAML에 자신을 연결합니다. 생성자에 추가 초기화 코드를 App 추가할 수 있지만 일반적으로 처리기를 애플리케이션 이벤트에 연결하는 코드만 추가합니다. 다른 초기화 코드의 경우 OnLaunched와 같은 하나 이상의 초기화 메서드를 재정의해야 합니다.

시스템은 사용자가 다른 앱 또는 데스크톱으로 전환할 때마다 앱을 일시 중단하고 사용자가 앱으로 다시 전환할 때마다 앱을 다시 시작하면 앱 수명을 처리합니다. 그러나 시스템은 리소스를 확보하기 위해 일시 중단된 동안 앱을 종료할 수도 있습니다.

일시 중단 이벤트를 처리하여 종료 시 앱 상태를 저장하고 OnLaunched 메서드를 재정의하여 앱 상태를 복원해야 합니다. 앱이 일시 중단되는 동안 변경되었을 수 있는 표시된 콘텐츠를 새로 고쳐야 하는 경우에만 Resuming 이벤트를 처리해야 합니다. 앱이 다시 시작될 때 다른 앱 상태를 복원할 필요가 없습니다.

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

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

참고

애플리케이션 주 파일의 이름은 App.xaml이어야 합니다.

데스크톱 앱에서 실행할 때 시스템에서 다음 이벤트 및 가상 메서드를 자동으로 호출 하지 않습니다 .

  • void OnWindowCreated(Windows.UI.Xaml.WindowCreatedEventArgs args)
  • void overridable OnActivated(IActivatedEventArgs args)
  • void overridable OnBackgroundActivated (BackgroundActivatedEventArgs)
  • void overridable OnCachedFileUpdaterActivated (CachedFileUpdaterActivatedEventArgs)
  • void overridable OnFileActivated (FileActivatedEventArgs)
  • void overridable OnFileOpenPickerActivated (FileOpenPickerActivatedEventArgs)
  • void overridable OnFileSavePickerActivated (FileSavePickerActivatedEventArgs)
  • void overridable OnSearchActivated (SearchActivatedEventArgs)
  • void overridable OnShareTargetActivated (ShareTargetActivatedEventArgs)
  • EnteredBackgroundEventHandler EnteredBackground;
  • LeavingBackgroundEventHandler LeavingBackground;
  • EventHandler<Object> Resuming

생성자

Application()

Application 클래스의 새 인스턴스를 초기화합니다.

속성

Current

현재 애플리케이션에 대한 Application 개체를 가져옵니다.

DebugSettings

디버그 환경에서 실행할 때 앱이 작동하는 방식을 선언하는 개체를 가져옵니다.

FocusVisualKind

앱이 포커스가 있는 UI 요소를 나타내는 데 사용할 수 있는 시각적 피드백 유형을 가져오거나 설정합니다.

이 속성은 키보드 또는 Xbox 컨트롤러와 같은 키 이벤트를 생성할 수 있는 입력 장치에만 유효합니다.

HighContrastAdjustment

고대비 테마를 사용할 때 프레임워크가 시각적 속성을 자동으로 조정하는지 여부를 나타내는 값을 가져오거나 설정합니다.

RequestedTheme

앱의 전체 테마에 대한 밝은 어두운 기본 설정을 결정하는 값을 가져오거나 설정합니다.

Resources

스타일, 템플릿 및 브러시와 같은 애플리케이션 범위 리소스의 컬렉션을 가져옵니다.

메서드

Exit()

앱을 종료합니다.

LoadComponent(Object, Uri)

지정된 상대 위치에 있는 XAML 파일을 로드하고 XAML 파일의 루트 요소로 지정된 개체의 인스턴스로 변환합니다.

LoadComponent(Object, Uri, ComponentResourceLocation)

지정된 상대 위치에 있는 XAML 파일을 로드하고 XAML 파일의 루트 요소로 지정된 개체의 인스턴스로 변환합니다.

OnLaunched(LaunchActivatedEventArgs)

애플리케이션이 시작될 때 호출됩니다. 애플리케이션 초기화를 수행하고 새 창을 만들려면 이 메서드를 재정의합니다.

Start(ApplicationInitializationCallback)

진입점을 제공하고 애플리케이션의 초기화를 요청합니다. 지정된 ApplicationInitializationCallback 을 사용하여 Application 클래스를 인스턴스화합니다.

이벤트

UnhandledException

네이티브 수준 Windows 런타임 오류에서 전달된 대로 앱 코드에서 예외를 처리할 수 있는 경우에 발생합니다. 앱은 이벤트 데이터에서 처리된 것으로 발생을 표시할 수 있습니다.

적용 대상

추가 정보