AppInstance 클래스

정의

네임스페이스:

Windows.ApplicationModel

앱의 인스턴스를 나타냅니다.

public ref class AppInstance sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppInstance final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppInstance

Public NotInheritable Class AppInstance

상속

Object Platform::Object IInspectable AppInstance

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v6.0에서 도입되었습니다.)

설명

시스템은 앱 인스턴스의 저장소를 유지 관리합니다. 앱은 활성화를 시도할 때 이를 앱 리디렉션에 사용할 수 있습니다.

앱 프로세스가 앱의 메서드에서 Main 만들어지면 현재 인스턴스를 계속 활성화하거나 활성화를 기존 인스턴스로 리디렉션하도록 선택할 수 있습니다.

셸은 리디렉션을 위한 기본 인스턴스를 제공할 수 있습니다. 앱은 해당 인스턴스로 리디렉션하는 것이 좋습니다. 리디렉션할지 여부는 앱과 함께 유지합니다.

AppInstance 클래스는 앱의 메서드에서 Main 사용됩니다. 이 클래스가 나중에 사용되는 경우 속성 값은 일 수 null있으며 메서드가 실패할 수 있습니다.

인스턴스를 반환하려면 FindOrRegisterInstanceForKey에 등록해야 합니다.

이 클래스는 다중 인스턴싱에 옵트인한 앱에서만 사용할 수 있습니다. 앱에 대한 패키지 매니페스트의 Application 요소에서 SupportsMultipleInstances 특성을 지정합니다.

속성

IsCurrentInstance	앱의 현재 인스턴스가 이 인스턴스가 정의한 특정 키에 대해 앱의 등록된 인스턴스인지 여부입니다.
Key	현재 인스턴스의 키입니다.
RecommendedInstance	셸은 애플리케이션 활성화가 리디렉션되는 앱의 인스턴스를 추천할 수 있습니다.

메서드

FindOrRegisterInstanceForKey(String)	플랫폼에 앱 인스턴스를 등록하거나 다른 인스턴스가 이 키를 이미 등록한 경우 기존 인스턴스를 찾습니다.
GetActivatedEventArgs()	앱의 OnActivated 메서드에 일반적으로 전달되는 것과 동일한 현재 IActivatedEventArgs를 가져옵니다.
GetInstances()	현재 앱의 등록된 인스턴스를 가져옵니다.
RedirectActivationTo()	현재 앱 인스턴스의 활성화를 지정된 인스턴스로 리디렉션합니다.
Unregister()	현재 인스턴스를 활성화 리디렉션에 더 이상 사용할 수 없도록 시스템 캐시를 업데이트.

추가 정보

• 다중 인스턴스 유니버설 Windows 앱 만들기