Compartir a través de


AppInstance Clase

Definición

Representa una instancia de una aplicación.

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
Herencia
Object Platform::Object IInspectable AppInstance
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)

Comentarios

El sistema mantiene un almacén de instancias de aplicación. Las aplicaciones pueden usarlo para redirigir una aplicación cuando intenta activarla.

Cuando se crea un proceso de aplicación en el Main método de la aplicación, puede optar por continuar activando la instancia actual o redirigir la activación a una instancia existente.

El shell puede proporcionar una instancia preferida para el redireccionamiento. Se recomienda que la aplicación redirija a esa instancia. La elección de si la redirección permanece con la aplicación.

La clase AppInstance está pensada para usarse en el Main método de la aplicación. Si esta clase se usa más adelante, los valores de propiedad pueden ser nully los métodos pueden producir un error.

Antes de que se puedan devolver instancias, deben registrarse con FindOrRegisterInstanceForKey.

Esta clase solo se puede usar desde una aplicación que ha optado por realizar instancias múltiples. Especifique el atributo SupportsMultipleInstances en el elemento Application del manifiesto del paquete de la aplicación.

Propiedades

IsCurrentInstance

Si la instancia actual de la aplicación es la instancia registrada de la aplicación para la clave específica que esta instancia ha definido.

Key

Clave de la instancia actual.

RecommendedInstance

Un shell puede recomendar una instancia de una aplicación a la que se redirige la activación de una aplicación.

Métodos

FindOrRegisterInstanceForKey(String)

Registra una instancia de aplicación con la plataforma o busca una instancia existente si otra instancia ya ha registrado esta clave.

GetActivatedEventArgs()

Obtiene el IActivatedEventArgs actual, el mismo que normalmente se pasaría al método OnActivated de la aplicación.

GetInstances()

Obtiene las instancias registradas de la aplicación actual.

RedirectActivationTo()

Redirige la activación de la instancia de aplicación actual a la instancia especificada.

Unregister()

Novedades la memoria caché del sistema para que la instancia actual ya no esté disponible para el redireccionamiento de activación.

Se aplica a

Consulte también