ICLRRuntimeHost, interface
Fournit des fonctionnalités similaires à celles de l’interface ICorRuntimeHost fournie dans le .NET Framework version 1, avec les modifications suivantes :
Ajout de la méthode SetHostControl pour définir l’interface de contrôle hôte.
Omission de certaines méthodes fournies par
ICorRuntimeHost.
Méthodes
| Méthode | Description |
|---|---|
| ExecuteApplication, méthode | Utilisée dans les scénarios de déploiement ClickOnce basés sur le manifeste pour spécifier l’application à activer dans un nouveau domaine. |
| ExecuteInAppDomain, méthode | Spécifie le AppDomain dans lequel exécuter le code managé spécifié. |
| ExecuteInDefaultAppDomain, méthode | Appelle la méthode spécifiée du type spécifié dans l’assembly spécifié. |
| GetCLRControl, méthode | Obtient un pointeur d’interface de type ICLRControl que les hôtes peuvent utiliser pour personnaliser les aspects du Common Language Runtime (CLR). |
| GetCurrentAppDomainId, méthode | Obtient l’identificateur numérique du AppDomain en cours d’exécution. |
| SetHostControl, méthode | Définit l’interface du contrôle hôte. Vous devez appeler SetHostControl avant d’appeler Start. |
| Start, méthode | Initialise le CLR dans un processus. |
| Stop, méthode | Arrête l’exécution du code par le runtime. |
| UnloadAppDomain, méthode | Décharge le AppDomain qui correspond à l’identificateur numérique spécifié. |
Notes
À compter du .NET Framework 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 versions antérieures du .NET Framework, l’hôte obtient un pointeur vers une instance ICLRRuntimeHost en appelant CorBindToRuntimeEx ou CorBindToCurrentRuntime. Pour fournir des implémentations de l’une des technologies fournies dans le .NET Framework version 2.0, vous devez utiliser ICLRRuntimeHost au lieu de ICorRuntimeHost.
Important
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 de méthode ExecuteApplication échoue.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MsCorEE.dll
Versions de .NET Framework : Disponible depuis la version 2.0
