ICLRRuntimeHost, interface

Fournit des fonctionnalités similaires à celles de l'interface ICorRuntimeHost proposée dans la version 1 du .NET Framework, avec les changements suivants :

  • l'ajout de la méthode SetHostControl pour définir l'interface de contrôle de l'hôte ;

  • l'omission de certaines méthodes fournies par ICorRuntimeHost.

Méthodes

Méthode

Description

ICLRRuntimeHost::ExecuteApplication, méthode

Utilisé dans les scénarios de déploiement ClickOnce basés sur un manifeste pour spécifier l'application à activer dans un nouveau domaine.

ICLRRuntimeHost::ExecuteInAppDomain, méthode

Spécifie le AppDomain dans lequel exécuter le code managé spécifié.

ICLRRuntimeHost::ExecuteInDefaultAppDomain, méthode

Appelle la méthode spécifiée du type spécifié dans l'assembly spécifié.

ICLRRuntimeHost::GetCLRControl, méthode

Obtient un pointeur d'interface de type ICLRControl que les hôtes peuvent utiliser pour personnaliser des aspects du Common Language Runtime (CLR).

ICLRRuntimeHost::GetCurrentAppDomainId, méthode

Obtient l'identificateur numérique du AppDomain en cours d'exécution.

ICLRRuntimeHost::SetHostControl, méthode

Définit l'interface de contrôle de l'hôte. Vous devez appeler SetHostControl avant d'appeler Start.

ICLRRuntimeHost::Start, méthode

Initialise le CLR dans un processus.

ICLRRuntimeHost::Stop, méthode

Arrête l'exécution du code par le runtime.

ICLRRuntimeHost::UnloadAppDomain, méthode

Décharge le AppDomain qui correspond à l'identificateur numérique spécifié.

Notes

En commençant par le .NET Framework version 4, utilisez l'interface ICLRMetaHost pour obtenir un pointeur vers l'interface ICLRRuntimeInfo, puis appelez la méthode ICLRRuntimeInfo::GetInterface pour obtenir un pointeur vers ICLRRuntimeHost. Dans les version antérieures de .NET Framework, l'hôte obtient un pointeur vers une instance ICLRRuntimeHost en appelant CorBindToRuntimeEx ou CorBindToCurrentRuntime. Pour fournir des implémentations de chacune des technologies fournies dans le .NET Framework version 2.0, vous devez utiliser ICLRRuntimeHost à la place de ICorRuntimeHost.

Remarque importanteImportant

N'appelez pas la méthode Start avant d'appeler la méthode ExecuteApplication pour activer une application basée sur un manifeste.Si la méthode Start est appelée en premier, l'appel à la méthode ExecuteApplication échoue.

Spécifications

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

CorBindToCurrentRuntime, fonction

CorBindToRuntimeEx, fonction

ICLRControl, interface

ICorRuntimeHost, interface

Coclasse CLRRuntimeHost

Concepts

Vue d'ensemble de l'hébergement

Autres ressources

Interfaces d'hébergement

Historique des modifications

Date

Historique

Motif

Juin 2010

A corrigé les instructions pour obtenir un pointeur vers l'interface.

Résolution des bogues de contenu.