CoreApplication Clase

  • Referencia

Definición

Espacio de nombres:
Windows.ApplicationModel.Core
Editar

Permite a las aplicaciones controlar los cambios de estado, administrar ventanas e integrarse con una variedad de marcos de interfaz de usuario.

public ref class CoreApplication abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreApplication final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CoreApplication
Public Class CoreApplication
Herencia
Object Platform::Object IInspectable CoreApplication
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

El sistema crea este objeto como singleton cuando ejecuta la aplicación. Se ejecuta como application Single-Threaded Apartment (ASTA). Los subprocesos creados a partir del singleton de la aplicación, como el proveedor de vistas (visto en el ejemplo siguiente), se deben atribuir como Multi-Threaded Apartment (MTAThread).

Esta API solo se admite en Plataforma universal de Windows aplicaciones, excepto en la propiedad Properties, que siempre está disponible.

struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
public:
    IFrameworkView CreateView()
    {
        return *this;
    }
};

...

int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    Windows::ApplicationModel::Core::CoreApplication::Run(App());
}

ref class MyFrameworkViewSource : IFrameworkViewSource
{
public:
    virtual IFrameworkView^ CreateView()
    {
        return ref new MyFrameworkView();
    }
};

// ...

[Platform::MTAThread]
int main(Platform::Array<Platform::String^>^)
{
    auto frameworkViewSource = ref new MyFrameworkViewSource();
    Windows::ApplicationModel::Core::CoreApplication::Run(frameworkViewSource);
    return 0;
}

internal class ApplicationSource : IFrameworkViewSource
{
	public virtual IFrameworkView CreateView()
	{
		return new CoreApp();
	}
}

...

[MTAThread]
public static int Main()
{
	var appSource = new ApplicationSource();
	CoreApplication.Run(appSource);
	return 0;
}

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 BackgroundActivated
1607 14393 EnablePrelaunch
1607 14393 EnteredBackground
1607 14393 LeavingBackground
1709 16299 RequestRestartAsync
1709 16299 RequestRestartForUserAsync

Propiedades

Id

Obtiene el identificador de aplicación relativa al paquete para el proceso.
MainView

Obtiene la instancia principal de CoreApplicationView para todas las aplicaciones en ejecución que usan esta instancia de CoreApplication .
Properties

Obtiene un conjunto de propiedades que las plataformas de la aplicación y la interfaz de usuario pueden usar para almacenar información mientras se ejecuta el proceso.
Views

Obtiene todas las vistas de la aplicación.

Métodos

CreateNewView()

Crea una nueva vista para la aplicación.
CreateNewView(IFrameworkViewSource)

Crea una nueva vista para la aplicación.
CreateNewView(String, String)

Crea una nueva vista para la aplicación.
DecrementApplicationUseCount()

Disminuye el recuento total de instancias de aplicación en ejecución que usan esta instancia de CoreApplication .
EnablePrelaunch(Boolean)

Habilite o deshabilite la capacidad del sistema operativo para iniciar previamente la aplicación.
Exit()

Apaga la aplicación.
GetCurrentView()

Obtiene la vista correspondiente al subproceso actual.
IncrementApplicationUseCount()

Incrementa el recuento total de instancias de aplicación en ejecución que usan esta instancia de CoreApplication .
RequestRestartAsync(String)

Reinicie la aplicación.
RequestRestartForUserAsync(User, String)

Reinicie la aplicación en el contexto de un usuario diferente.
Run(IFrameworkViewSource)

Ejecuta un generador de proveedores de vistas externo para obtener un proveedor de vistas.
RunWithActivationFactories(IGetActivationFactory)

Ejecuta un generador de tipos activable para obtener un tipo activable externo.

Eventos

BackgroundActivated

Se desencadena cuando un desencadenador en segundo plano activa la aplicación.
EnteredBackground

Se desencadena cuando la aplicación entra en ejecución en el estado en segundo plano.
Exiting

Se produce cuando la aplicación se apaga.
LeavingBackground

Se desencadena justo antes de que la interfaz de usuario de la aplicación sea visible.
Resuming

Se produce cuando se reanuda una aplicación.
Suspending

Se produce cuando la aplicación se suspende.
UnhandledErrorDetected

Se produce cuando hay un error subyacente que se enruta a la instancia de CoreApplication , como parte de la lógica global de control de errores.

Se aplica a

Consulte también