AppInstance Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 AppInstancePublic NotInheritable Class AppInstance- Herencia
- 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. |