Interfaces d'hébergement du CLR

Cette section décrit les interfaces que les hôtes non managés peuvent utiliser pour intégrer le Common Language Runtime (CLR) dans leurs applications. Les informations se rapportent à .NET Framework version 2.0 et les versions ultérieures. Ces interfaces permettent à l’hôte de contrôler beaucoup plus d’aspects du runtime que ce qui était possible dans les versions 1.0 et 1.1, et fournissent une intégration beaucoup plus étroite entre le CLR et le modèle d’exécution de l’hôte.

Dans le .NET Framework version 1.0 et 1.1, le modèle d’hébergement permettait à un hôte non managé de charger le CLR dans un processus, de configurer certains paramètres et de recevoir des notifications d’événements. Cependant, en général, l’hôte et le CLR s’exécutaient indépendamment dans ce processus. Dans le .NET Framework version 2.0 et ultérieures, de nouvelles couches d’abstraction permettent à l’hôte de fournir la plupart des ressources actuellement fournies par les types dans l’assembly Win32, et d’étendre l’ensemble des fonctionnalités que l’hôte peut configurer.

Dans cette section

IActionOnCLREvent, interface
Fournit une méthode qui effectue un rappel pour un événement inscrit.

IApartmentCallback, interface
Fournit des méthodes pour effectuer des rappels au sein d’un cloisonnement.

IAppDomainBinding, interface
Fournit des méthodes pour définir la configuration au moment de l’exécution.

ICatalogServices, interface
Fournit des méthodes pour les services de catalogage. (Cette interface prend en charge l’infrastructure .NET Framework et n’est pas destinée à être utilisée directement à partir de votre code.)

ICLRAssemblyIdentityManager, interface
Fournit des méthodes qui prennent en charge la communication entre l’hôte et le CLR à propos des assemblys.

ICLRAssemblyReferenceList, interface
Gère une liste d’assemblys qui sont chargés par le CLR et non pas par l’hôte.

ICLRControl, interface
Fournit des méthodes permettant à l’hôte d’accéder au CLR et d’en configurer différents aspects.

ICLRDebugManager, interface
Fournit des méthodes qui permettent à un hôte d’associer un ensemble de tâches à un identificateur et à un nom convivial.

ICLRErrorReportingManager, interface
Fournit des méthodes permettant à l’hôte de configurer des vidages du tas personnalisés pour la production de rapports d’erreurs.

ICLRGCManager, interface
Fournit des méthodes permettant à un hôte d’interagir avec le système de garbage collection du CLR.

ICLRHostBindingPolicyManager, interface
Fournit des méthodes permettant à l’hôte d’évaluer et de communiquer les modifications apportées aux informations de stratégie pour les assemblys.

ICLRHostProtectionManager, interface
Permet à l’hôte de bloquer l’exécution de classes managées, de méthodes, de propriétés et de champs spécifiques dans du code partiellement approuvé.

ICLRIoCompletionManager, interface
Implémente une méthode de rappel qui permet à l’hôte d’informer le CLR de l’état des demandes d’E/S spécifiées.

ICLRMemoryNotificationCallback, interface
Permet à l’hôte de signaler les conditions de sollicitation de la mémoire selon une approche similaire à celle de la fonction Win32 CreateMemoryResourceNotification.

ICLROnEventManager, interface
Fournit des méthodes qui permettent à l’hôte d’inscrire et de désinscrire des rappels pour les événements du CLR.

ICLRPolicyManager, interface
Fournit des méthodes qui permettent à l’hôte de spécifier des actions de stratégie à entreprendre en cas d’échecs et d’expirations de délai d’attente.

ICLRProbingAssemblyEnum, interface
Fournit des méthodes qui permettent à l’hôte d’obtenir les identités de détection d’un assembly en utilisant les informations d’identité de l’assembly internes au CLR, sans devoir créer ou comprendre cette identité.

ICLRReferenceAssemblyEnum, interface
Fournit des méthodes qui permettent à l’hôte de manipuler l’ensemble des assemblys référencés par un fichier ou un flux en utilisant des données d’identité d’assembly internes au CLR, sans devoir créer ou comprendre ces identités.

ICLRRuntimeHost, interface
Fournit des fonctionnalités similaires à ICorRuntimeHost, avec une méthode supplémentaire pour définir l’interface de contrôle de l’hôte.

ICLRSyncManager, interface
Définit les méthodes qui permettent à l’hôte d’obtenir des informations sur les tâches demandées et de détecter les interblocages dans son implémentation de la synchronisation.

ICLRTask, interface
Fournit des méthodes qui permettent à l’hôte d’effectuer des demandes auprès du CLR ou de fournir une notification au CLR sur la tâche associée.

ICLRTaskManager, interface
Fournit des méthodes qui permettent à l’hôte de demander explicitement au CLR de créer une tâche, d’obtenir la tâche en cours d’exécution, et de définir la langue et la culture géographiques pour la tâche.

ICLRValidator, interface
Fournit des méthodes pour valider des images de fichier exécutable portable (PE) et signaler des erreurs de validation.

ICorConfiguration, interface
Fournit des méthodes pour configurer le CLR.

ICorThreadpool, interface
Fournit des méthodes pour accéder au pool de threads.

IDebuggerInfo, interface
Fournit des méthodes pour obtenir des informations sur l’état des services de débogage.

IDebuggerThreadControl, interface
Fournit des méthodes pour informer l’hôte du blocage et du déblocage des threads par les services de débogage.

IGCHost, interface
Fournit des méthodes pour obtenir des informations sur le système de garbage collection et pour contrôler certains aspects du garbage collection.

IGCHost2, interface
Fournit la méthode SetGCStartupLimitsEx, qui permet à un hôte de définir la taille de segment du garbage collection et la taille maximale de la génération zéro du système de garbage collection sur des valeurs supérieures à DWORD.

IGCHostControl, interface
Fournit une méthode qui permet au récupérateur de mémoire de demander à l’hôte de modifier les limites de la mémoire virtuelle.

IGCThreadControl, interface
Fournit des méthodes pour participer à la planification des threads qui sinon seraient bloqués pour le garbage collection.

IHostAssemblyManager, interface
Fournit des méthodes permettant à un hôte de spécifier des ensembles d’assemblys qui doivent être chargés par le CLR ou par l’hôte.

IHostAssemblyStore, interface
Fournit des méthodes qui permettent à un hôte de charger des assemblys et des modules indépendamment du CLR.

IHostAutoEvent, interface
Fournit une représentation de d’un événement de réinitialisation automatique implémenté par l’hôte.

IHostControl, interface
Fournit des méthodes pour configurer le chargement des assemblys et déterminer les interfaces d’hébergement prises en charge par l’hôte.

IHostCrst, interface
Sert de représentation de l’hôte d’une section critique pour le threading.

IHostGCManager, interface
Fournit des méthodes qui informent l’hôte des événements dans le mécanisme de garbage collection implémenté par le CLR.

IHostIoCompletionManager, interface
Fournit des méthodes qui permettent au CLR d’interagir avec des ports de réalisation des E/S fournis par l’hôte.

IHostMalloc, interface
Fournit des méthodes pour que le CLR demande des allocations précises du tas via l’hôte.

IHostManualEvent, interface
Fournit l’implémentation de l’hôte d’une représentation d’un événement de réinitialisation manuelle.

IHostMemoryManager, interface
Fournit des méthodes qui permettent au CLR d’effectuer des demandes de mémoire virtuelle via l’hôte, au lieu d’utiliser les fonctions de mémoire virtuelle Win32 standard.

IHostPolicyManager, interface
Fournit des méthodes qui informent l’hôte des actions effectuées par le CLR en cas d’abandons, de dépassements de délai d’expiration ou d’échecs.

IHostSecurityContext, interface
Permet au CLR de maintenir les informations de contexte de sécurité implémentées par l’hôte.

IHostSecurityManager, interface
Fournit des méthodes qui permettent d’accéder au contexte de sécurité du thread actuellement en cours d’exécution et de le contrôler.

IHostSemaphore, interface
Fournit une représentation d’un sémaphore implémenté par l’hôte.

IHostSyncManager, interface
Fournit des méthodes qui permettent au CLR de créer des primitives de synchronisation en appelant l’hôte, au lieu d’utiliser les fonctions de synchronisation Win32.

IHostTask, interface
Fournit des méthodes qui permettent au CLR de communiquer avec l’hôte pour gérer des tâches.

IHostTaskManager, interface
Fournit des méthodes qui permettent au CLR d’utiliser des tâches via l’hôte, au lieu d’utiliser les fonctions de threading ou de fibre du système d’exploitation standard.

IHostThreadPoolManager, interface
Fournit des méthodes qui permettent au CLR de configurer le pool de threads et de mettre en file d’attente les éléments de travail pour le pool de threads.

IManagedObject, interface
Fournit des méthodes pour contrôler un objet managé.

« IObjectHandle »
Fournit une méthode pour désencapsuler les objets marshal-by-value de l’indirection.

ITypeName, interface
Fournit des méthodes pour obtenir des informations de nom de type. (Cette interface prend en charge l’infrastructure .NET Framework et n’est pas destinée à être utilisée directement à partir de votre code.)

ITypeNameBuilder, interface
Fournit des méthodes pour créer un nom de type. (Cette interface prend en charge l’infrastructure .NET Framework et n’est pas destinée à être utilisée directement à partir de votre code.)

ITypeNameFactory, interface
Fournit des méthodes pour la déconstruction d’un nom de type. (Cette interface prend en charge l’infrastructure .NET Framework et n’est pas destinée à être utilisée directement à partir de votre code.)

« IValidator »
Fournit des méthodes pour valider des images de fichier exécutable portable (PE) et signaler des erreurs de validation.

Sections connexes

Interfaces d'hébergement du CLR et coclasses déconseillées
Contient des rubriques qui décrivent les interfaces d’hébergement fournies dans le .NET Framework version 1.0 et 1.1.

Interfaces d'hébergement du CLR ajoutées dans .NET Framework 4 et 4.5
Contient des rubriques qui décrivent les interfaces d’hébergement fournies dans le .NET Framework 4.