ICLRRuntimeHost Interface
Fornece funcionalidades semelhantes às da interface ICorRuntimeHost fornecida no .NET Framework versão 1, com as seguintes alterações:
A adição do método SetHostControl para definir a interface de controlo do anfitrião.
A omissão de alguns métodos fornecidos pelo
ICorRuntimeHost.
Métodos
| Método | Descrição |
|---|---|
| Método ExecuteApplication | Utilizado em cenários de implementação ClickOnce baseados em manifestos para especificar a aplicação a ser ativada num novo domínio. |
| Método ExecuteInAppDomain | Especifica o AppDomain para executar o código gerido especificado. |
| Método ExecuteInDefaultAppDomain | Invoca o método especificado do tipo especificado na assemblagem especificada. |
| Método GetCLRControl | Obtém um ponteiro de interface do tipo ICLRControl que os anfitriões podem utilizar para personalizar aspetos do runtime de linguagem comum (CLR). |
| Método GetCurrentAppDomainId | Obtém o identificador numérico do AppDomain que está a ser executado atualmente. |
| Método SetHostControl | Define a interface de controlo do anfitrião. Tem de ligar SetHostControl antes de ligar Startpara . |
| Método Iniciar | Inicializa o CLR num processo. |
| Método Stop | Interrompe a execução do código pelo runtime. |
| Método UnloadAppDomain | Descarrega o AppDomain que corresponde ao identificador numérico especificado. |
Observações
A partir do .NET Framework 4, utilize a interface ICLRMetaHost para obter um ponteiro para a interface ICLRRuntimeInfo e, em seguida, chame o método ICLRRuntimeInfo::GetInterface para obter um ponteiro para ICLRRuntimeHost. Em versões anteriores do .NET Framework, o anfitrião obtém um ponteiro para uma ICLRRuntimeHost instância ao chamar CorBindToRuntimeEx ou CorBindToCurrentRuntime. Para fornecer implementações de qualquer uma das tecnologias fornecidas no .NET Framework versão 2.0, tem de utilizar ICLRRuntimeHost em vez de ICorRuntimeHost.
Importante
Não chame o método Iniciar antes de chamar o método ExecuteApplication para ativar uma aplicação baseada em manifesto. Se o Start método for chamado primeiro, a chamada do ExecuteApplication método falhará.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0
