ICLRRuntimeHost (Interfaz)
Proporciona una funcionalidad similar a la de la interfaz ICorRuntimeHost proporcionada en la versión 1 de .NET Framework, con los siguientes cambios:
La adición del método SetHostControl para establecer la interfaz de control de host.
La omisión de algunos métodos proporcionados por
ICorRuntimeHost
.
Métodos
Método | Descripción |
---|---|
Método ExecuteApplication | Se usa en escenarios de implementación ClickOnce basados en manifiestos para especificar la aplicación que se va a activar en un nuevo dominio. |
Método ExecuteInAppDomain | Especifica en qué elemento AppDomain se va a ejecutar el código administrado especificado. |
Método ExecuteInDefaultAppDomain | Invoca al método especificado del tipo especificado en el ensamblado especificado. |
Método GetCLRControl | Obtiene un puntero de interfaz de tipo ICLRControl que los hosts pueden usar para personalizar aspectos de Common Language Runtime (CLR). |
Método GetCurrentAppDomainId | Obtiene el identificador numérico del elemento AppDomain que se está ejecutando actualmente. |
Método SetHostControl | Establece la interfaz de control de host. Debe llamar a SetHostControl antes de llamar a Start . |
Start (método) | Inicializa el CLR en un proceso. |
Stop (método) | Detiene la ejecución del código por el tiempo de ejecución. |
Método UnloadAppDomain | Descarga el elemento AppDomain que corresponde al identificador numérico especificado. |
Comentarios
A partir de .NET Framework 4, use la interfaz ICLRMetaHost para obtener un puntero a la interfaz ICLRRuntimeInfo y, a continuación, llame al método ICLRRuntimeInfo::GetInterface para obtener un puntero en ICLRRuntimeHost
. En versiones anteriores de .NET Framework, el host obtiene un puntero a una ICLRRuntimeHost
instancia mediante una llamada a CorBindToRuntimeEx o CorBindToCurrentRuntime. Para proporcionar implementaciones de cualquiera de las tecnologías proporcionadas en .NET Framework versión 2.0, debe usar ICLRRuntimeHost
en lugar de ICorRuntimeHost
.
Importante
No llame al método Start Method antes de llamar al método ExecuteApplication para activar una aplicación basada en manifiestos. Si se llama primero al método Start
, se producirá un error en la llamada de método ExecuteApplication
.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: MSCorEE.h
Biblioteca: incluida como recurso en MSCorEE.dll
Versiones de .NET Framework: disponible a partir de la versión 2.0