Condividi tramite


Interfaccia ICLRRuntimeHost

Fornisce funzionalità simili a quella dell'interfaccia ICorRuntimeHost fornita in .NET Framework versione 1, con le modifiche seguenti:

  • Aggiunta del metodo SetHostControl per impostare l'interfaccia del controllo host.

  • Omissione di alcuni metodi forniti da ICorRuntimeHost.

Metodi

Metodo Descrizione
Metodo ExecuteApplication Usato negli scenari di distribuzione ClickOnce basati su manifesto per specificare l'applicazione da attivare in un nuovo dominio.
Metodo ExecuteInAppDomain Specifica l'oggetto AppDomain in cui eseguire il codice gestito specificato.
Metodo ExecuteInDefaultAppDomain Richiama il metodo specificato del tipo specificato nell'assembly specificato.
Metodo GetCLRControl Ottiene un puntatore di interfaccia di tipo ICLRControl che gli host possono usare per personalizzare gli aspetti di Common Language Runtime (CLR).
Metodo GetCurrentAppDomainId Ottiene l'identificatore numerico dell'oggetto AppDomain attualmente in esecuzione.
Metodo SetHostControl Imposta l'interfaccia del controllo host. È necessario chiamare prima di chiamare SetHostControlStart.
Start, metodo Inizializza CLR in un processo.
Stop, metodo Arresta l'esecuzione del codice dal runtime.
Metodo UnloadAppDomain Scarica l'oggetto AppDomain che corrisponde all'identificatore numerico specificato.

Commenti

A partire da .NET Framework 4, usare l'interfaccia ICLRMetaHost per ottenere un puntatore all'interfaccia ICLRRuntimeInfo e quindi chiamare il metodo ICLRRuntimeInfo::GetInterface per ottenere un puntatore a ICLRRuntimeHost. Nelle versioni precedenti di .NET Framework, l'host ottiene un puntatore a un'istanza ICLRRuntimeHost chiamando CorBindToRuntimeEx o CorBindToCurrentRuntime. Per fornire implementazioni di qualsiasi tecnologia fornita in .NET Framework versione 2.0, è necessario usare ICLRRuntimeHost anziché ICorRuntimeHost.

Importante

Non chiamare il metodo Start prima di chiamare il metodo ExecuteApplication per attivare un'applicazione basata su manifesto. Se il Start metodo viene chiamato per primo, la chiamata al ExecuteApplication metodo avrà esito negativo.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche