CoreApplication Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.Core

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

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: