Freigeben über

AppInstance Klasse

  • Referenz

Definition

Namespace:
Windows.ApplicationModel
Bearbeiten

Stellt eine Instanz einer App dar.

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
Vererbung
Object Platform::Object IInspectable AppInstance
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Hinweise

Das System verwaltet einen Speicher von App-Instanzen. Apps können dies für die Umleitung einer App verwenden, wenn sie versucht, zu aktivieren.

Wenn ein App-Prozess in der Main -Methode der App erstellt wird, kann er auswählen, ob er die aktuelle Instanz weiterhin aktiviert oder die Aktivierung an eine vorhandene Instanz umleitet.

Die Shell kann eine bevorzugte Instanz für die Umleitung bereitstellen. Die App wird empfohlen, zu dieser Instanz umzuleiten. Die Wahl, ob umgeleitet werden soll, bleibt bei der App.

Die AppInstance-Klasse ist für die Verwendung in der Main -Methode der App vorgesehen. Wenn diese Klasse später verwendet wird, können die Eigenschaftswerte sein null, und die Methoden schlagen möglicherweise fehl.

Bevor Instanzen zurückgegeben werden können, müssen sie bei FindOrRegisterInstanceForKey registriert werden.

Diese Klasse kann nur von einer App verwendet werden, die sich für multi-instancing entschieden hat. Geben Sie das SupportsMultipleInstances-Attribut für das Application-Element im Paketmanifest für die App an.

Eigenschaften

IsCurrentInstance

Gibt an, ob die aktuelle Instanz der App die registrierte Instanz der App für den spezifischen Schlüssel ist, den diese Instanz definiert hat.
Key

Der Schlüssel für die aktuelle Instanz.
RecommendedInstance

Eine Shell kann eine Instanz einer App empfehlen, an die eine Anwendungsaktivierung umgeleitet wird.

Methoden

FindOrRegisterInstanceForKey(String)

Registriert eine App-Instanz bei der Plattform oder findet eine vorhandene Instanz, wenn dieser Schlüssel bereits von einer anderen Instanz registriert wurde.
GetActivatedEventArgs()

Ruft die aktuellen IActivatedEventArgs ab, dieselbe, die normalerweise an die OnActivated-Methode der App übergeben würde.
GetInstances()

Ruft die registrierten Instanzen der aktuellen App ab.
RedirectActivationTo()

Leitet die Aktivierung der aktuellen App-Instanz an die angegebene Instanz um.
Unregister()

Aktualisierungen den Systemcache, sodass die aktuelle Instanz nicht mehr für die Aktivierungsumleitung verfügbar ist.

Gilt für:

Weitere Informationen