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 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 앱 만들기