ICLRRuntimeHost, interface

  • Article

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

Voir aussi