Interfaccia ICLRRuntimeHost

Fornisce una funzionalità simile a quella dell'interfaccia ICorRuntimeHost disponibile in .NET Framework versione 1, con le seguenti differenze:

• L'aggiunta del metodo SetHostControl per impostare l'interfaccia di controllo host.

• L'omissione di alcuni metodi forniti da ICorRuntimeHost.

Metodi

Metodo	Oggetto di descrizione
Metodo ICLRRuntimeHost::ExecuteApplication	Utilizzato negli scenari di distribuzione ClickOnce basati su manifesto per specificare l'applicazione che deve essere attivata in un nuovo dominio.
Metodo ICLRRuntimeHost::ExecuteInAppDomain	Specifica il dominio AppDomain in cui eseguire il codice gestito specificato.
Metodo ICLRRuntimeHost::ExecuteInDefaultAppDomain	Richiama il metodo specificato del tipo specificato nell'assembly specificato.
Metodo ICLRRuntimeHost::GetCLRControl	Ottiene un puntatore a interfaccia di tipo ICLRControl che gli host possono utilizzare per la personalizzazione di aspetti di Common Language Runtime (CLR).
Metodo ICLRRuntimeHost::GetCurrentAppDomainId	Ottiene l'identificatore numerico dell'oggetto AppDomain attualmente in esecuzione.
Metodo ICLRRuntimeHost::SetHostControl	Imposta l'interfaccia di controllo host. È necessario chiamare SetHostControl prima di chiamare Start.
Metodo ICLRRuntimeHost::Start	Inizializza Common Language Runtime in un processo.
Metodo ICLRRuntimeHost::Stop	Arresta l'esecuzione di codice da parte del runtime.
Metodo ICLRRuntimeHost::UnloadAppDomain	Scarica AppDomain che corrisponde all'identificatore numerico specificato.

Note

A partire da .NET Framework versione 4, utilizzare l'interfaccia ICLRMetaHost per ottenere un puntatore all'interfaccia ICLRRuntimeInfo, quindi chiamare il metodo il ICLRRuntimeInfo::GetInterface per ottenere un puntatore a ICLRRuntimeHost. In versioni precedenti di .NET Framework, l’host ottiene un puntatore a un'istanza di ICLRRuntimeHost mediante una chiamata a CorBindToRuntimeEx o a CorBindToCurrentRuntime. Per consentire l'implementazione delle tecnologie fornite con .NET Framework versione 2.0, è necessario utilizzare ICLRRuntimeHost anziché ICorRuntimeHost.

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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Funzione CorBindToCurrentRuntime

Funzione CorBindToRuntimeEx

Interfaccia ICLRControl

Interfaccia ICorRuntimeHost

Coclasse CLRRuntimeHost

Concetti

Cenni preliminari sull'hosting

Altre risorse

Interfacce di hosting

Cronologia delle modifiche

Data	Cronologia	Motivo
Giugno 2010	Sono state corrette le istruzioni per ottenere un puntatore all'interfaccia.	Correzione di bug nel contenuto.