Freigeben über

ICLRRuntimeHost-Schnittstelle

  • Artikel

Stellt Funktionen bereit, die der ICorRuntimeHost--Schnittstelle in .NET Framework (Version 1) entspricht, mit den folgenden Änderungen:

  • Das Hinzufügen der SetHostControl--Methode zum Festlegen der Hoststeuerelementoberfläche.

  • Die Unterlassung einiger Methoden, die von ICorRuntimeHost bereitgestellt werden.

Methoden

Methode Beschreibung
ExecuteApplication-Methode Wird in manifestbasierten ClickOnce-Bereitstellungsszenarios verwendet, um die Anwendung anzugeben, die in einer neuen Domäne aktiviert werden soll.
ExecuteInAppDomain-Methode Gibt die AppDomain an, in der der angegebene verwaltete Code ausgeführt werden soll.
ExecuteInDefaultAppDomain-Methode Ruft die angegebene Methode des angegebenen Typs in der angegebenen Assembly auf.
GetCLRControl-Methode Ruft einen Schnittstellenzeiger vom Typ ICLRControl ab, den Hosts zur Anpassung von Aspekten der Common Language Runtime (CLR) verwenden können.
GetCurrentAppDomainId-Methode Ruft den numerischen Bezeichner der AppDomain ab, der gerade ausgeführt wird.
SetHostControl-Methode Legt die Hoststeuerelementoberfläche fest. Sie müssen SetHostControl aufrufen, bevor Sie Start aufrufen.
Start-Methode Initialisiert die CLR in einen Prozess.
Stop-Methode Beendet die Ausführung von Code durch die Laufzeit.
UnloadAppDomain-Methode Entlädt die AppDomain, die dem angegebenen numerischen Bezeichner entspricht.

Bemerkungen

Verwenden Sie ab .NET Framework 4 die ICLRMetaHost-Schnittstelle, um einen Zeiger auf die ICLRRuntimeInfo--Schnittstelle abzurufen, und rufen Sie dann die ICLRRuntimeInfo::GetInterface-Methode auf, um einen Zeiger auf ICLRRuntimeHost abzurufen. In früheren Versionen von .NET Framework ruft der Host einen Zeiger auf eine ICLRRuntimeHost-Instanz ab, indem CorBindToRuntimeEx oder CorBindToCurrentRuntime aufgerufen wird. Um Implementierungen einer der in .NET Framework (Version 2.0) bereitgestellten Technologien bereitzustellen, müssen Sie ICLRRuntimeHost anstelle von ICorRuntimeHost verwenden.

Wichtig

Rufen Sie die Start-Methode nicht auf, bevor Sie die ExecuteApplication-Methode aufrufen, um eine manifestbasierte Anwendung zu aktivieren. Wenn die Start-Methode zuerst aufgerufen wird, ist der Aufruf der ExecuteApplication-Methode nicht erfolgreich.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch