Freigeben über


CoreApplication Klasse

Definition

Ermöglicht Apps die Verarbeitung von Zustandsänderungen, das Verwalten von Fenstern und die Integration in eine Vielzahl von Ui-Frameworks.

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
Vererbung
Object Platform::Object IInspectable CoreApplication
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Das System erstellt dieses Objekt als Singleton, wenn es die App ausführt. Es wird als Application Single-Threaded Apartment (ASTA) ausgeführt. Threads, die aus der App Singleton erstellt wurden, z. B. der Ansichtsanbieter (siehe beispiel unten), sollten als MTAThread (Multi-Threaded Apartment) zugeordnet werden.

Diese API wird nur in Universelle Windows-Plattform-Apps unterstützt, mit Ausnahme der Eigenschaft Properties, die immer verfügbar ist.

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

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1607 14393 BackgroundActivated
1607 14393 EnablePrelaunch
1607 14393 EnteredBackground
1607 14393 LeavingBackground
1709 16299 RequestRestartAsync
1709 16299 RequestRestartForUserAsync

Eigenschaften

Id

Ruft den paketrelativen App-Bezeichner für den Prozess ab.

MainView

Ruft die Standard CoreApplicationView-instance für alle ausgeführten Apps ab, die dieses CoreApplication-instance verwenden.

Properties

Ruft einen Eigenschaftensatz ab, den die App und benutzeroberflächenframeworks verwenden können, um Informationen zu speichern, während der Prozess ausgeführt wird.

Views

Ruft alle Ansichten für die App ab.

Methoden

CreateNewView()

Erstellt eine neue Ansicht für die App.

CreateNewView(IFrameworkViewSource)

Erstellt eine neue Ansicht für die App.

CreateNewView(String, String)

Erstellt eine neue Ansicht für die App.

DecrementApplicationUseCount()

Verringert die Gesamtzahl der ausgeführten App-Instanzen, die diese CoreApplication-instance verwenden.

EnablePrelaunch(Boolean)

Aktivieren oder deaktivieren Sie die Möglichkeit des Betriebssystems, Ihre App vorab zu starten.

Exit()

Fährt die App herunter.

GetCurrentView()

Ruft die Ansicht ab, die dem aktuellen Thread entspricht.

IncrementApplicationUseCount()

Erhöht die Gesamtzahl der ausgeführten App-Instanzen, die diese CoreApplication-instance verwenden.

RequestRestartAsync(String)

Starten Sie die App neu.

RequestRestartForUserAsync(User, String)

Starten Sie die App im Kontext eines anderen Benutzers neu.

Run(IFrameworkViewSource)

Führt eine Factory eines externen Ansichtsanbieters aus, um einen Ansichtsanbieter abzurufen.

RunWithActivationFactories(IGetActivationFactory)

Führt eine aktivierbare Typfactory aus, um einen externen aktivierbaren Typ zu erhalten.

Ereignisse

BackgroundActivated

Wird ausgelöst, wenn Ihre App durch einen Hintergrundtrigger aktiviert wird.

EnteredBackground

Wird ausgelöst, wenn die App in den Im Hintergrund ausgeführten Zustand wechselt.

Exiting

Tritt auf, wenn die App heruntergefahren wird.

LeavingBackground

Wird ausgelöst, bevor die Anwendungsbenutzeroberfläche sichtbar wird.

Resuming

Tritt auf, wenn eine App fortgesetzt wird.

Suspending

Tritt auf, wenn die App angehalten wird.

UnhandledErrorDetected

Tritt auf, wenn ein zugrunde liegender Fehler als Teil der globalen Fehlerbehandlungslogik an die CoreApplication-instance weitergeleitet wird.

Gilt für:

Weitere Informationen