CoreApplication Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.ApplicationModel.Core

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ContractVersionAttribute MarshalingBehaviorAttribute

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

Condividi tramite