Condividi tramite


CoreApplication Classe

Definizione

Consente alle app di gestire le modifiche dello stato, gestire le finestre e integrarsi con un'ampia gamma di framework dell'interfaccia utente.

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
Ereditarietà
Object Platform::Object IInspectable CoreApplication
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Il sistema crea questo oggetto come singleton quando esegue l'app. Viene eseguito come applicazione Single-Threaded Apartment (ASTA). I thread creati dal singleton dell'app, ad esempio il provider di visualizzazioni (illustrato nell'esempio seguente), devono essere attribuiti come Multi-Threaded Apartment (MTAThread).

Questa API è supportata solo nelle app piattaforma UWP (Universal Windows Platform), ad eccezione della proprietà Properties, sempre disponibile.

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;
}

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 BackgroundActivated
1607 14393 EnablePrelaunch
1607 14393 EnteredBackground
1607 14393 LeavingBackground
1709 16299 RequestRestartAsync
1709 16299 RequestRestartForUserAsync

Proprietà

Id

Ottiene l'identificatore dell'app relativa al pacchetto per il processo.

MainView

Ottiene l'istanza principale di CoreApplicationView per tutte le app in esecuzione che usano questa istanza di CoreApplication .

Properties

Ottiene un set di proprietà che i framework dell'app e dell'interfaccia utente possono usare per archiviare le informazioni durante l'esecuzione del processo.

Views

Ottiene tutte le visualizzazioni per l'app.

Metodi

CreateNewView()

Crea una nuova visualizzazione per l'app.

CreateNewView(IFrameworkViewSource)

Crea una nuova visualizzazione per l'app.

CreateNewView(String, String)

Crea una nuova visualizzazione per l'app.

DecrementApplicationUseCount()

Decrementa il numero totale di istanze dell'app in esecuzione che usano questa istanza di CoreApplication .

EnablePrelaunch(Boolean)

Abilitare o disabilitare la possibilità del sistema operativo di preavviare l'app.

Exit()

Arresta l'app.

GetCurrentView()

Ottiene la visualizzazione corrispondente al thread corrente.

IncrementApplicationUseCount()

Incrementa il numero totale di istanze dell'app in esecuzione che usano questa istanza di CoreApplication .

RequestRestartAsync(String)

Riavviare l'app.

RequestRestartForUserAsync(User, String)

Riavviare l'app nel contesto di un utente diverso.

Run(IFrameworkViewSource)

Esegue una factory del provider di viste esterna per ottenere un provider di viste.

RunWithActivationFactories(IGetActivationFactory)

Esegue una factory di tipi attivabile per ottenere un tipo attivabile esterno.

Eventi

BackgroundActivated

Generato quando l'app viene attivata da un trigger in background.

EnteredBackground

Generato quando l'app entra in esecuzione nello stato in background.

Exiting

Si verifica quando l'app viene arrestata.

LeavingBackground

Generato subito prima che l'interfaccia utente dell'applicazione diventi visibile.

Resuming

Si verifica quando viene ripresa un'app.

Suspending

Si verifica quando l'app viene sospesa.

UnhandledErrorDetected

Si verifica quando si verifica un errore sottostante indirizzato all'istanza di CoreApplication , come parte della logica di gestione degli errori globale.

Si applica a

Vedi anche