Algorithme de chargement d’assembly managé

Les assemblys managés se trouvent et sont chargés avec un algorithme qui a différentes étapes.

Tous les assemblys managés, à l’exception des assemblys satellites et WinRT des assemblys, utilisent le même algorithme.

Quand les assemblys managés sont-ils chargés ?

Le mécanisme le plus courant pour déclencher une charge d’assembly managé est une référence d’assembly statique. Ces références sont insérées par le compilateur chaque fois que le code utilise un type défini dans un autre assembly. Ces assemblys sont chargés (load-by-name) selon les besoins du runtime. Le moment exact du chargement des références d’assembly statique n’est pas spécifié. Il peut varier entre les versions du runtime et est influencé par des optimisations telles que l’incorporation.

L’utilisation directe des API suivantes déclenche également des chargements :

API (Interface de Programmation d'Applications)	Descriptif	Active AssemblyLoadContext
AssemblyLoadContext.LoadFromAssemblyName	Load-by-name	Instance.
AssemblyLoadContext.LoadFromAssemblyPath AssemblyLoadContext.LoadFromNativeImagePath	Chargez à partir du chemin d’accès.	Instance.
AssemblyLoadContext.LoadFromStream	Chargez à partir de l’objet.	Instance.
Assembly.LoadFile	Charger à partir d’un chemin d’accès dans une nouvelle AssemblyLoadContext instance	Nouvelle AssemblyLoadContext instance.
Assembly.LoadFrom	Chargez à partir du chemin d’accès dans l’instance AssemblyLoadContext.Default . Ajoute un AppDomain.AssemblyResolve gestionnaire. Le gestionnaire charge les dépendances de l’assembly à partir de son répertoire.	Instance AssemblyLoadContext.Default.
Assembly.Load(AssemblyName) Assembly.Load(String) Assembly.LoadWithPartialName	Load-by-name.	Déduit de l’appelant. Préférez les AssemblyLoadContext méthodes.
Assembly.Load(Byte[]) Assembly.Load(Byte[], Byte[])	Chargez à partir d’un objet dans une nouvelle AssemblyLoadContext instance.	Nouvelle AssemblyLoadContext instance.
Type.GetType(String) Type.GetType(String, Boolean) Type.GetType(String, Boolean, Boolean)	Load-by-name.	Déduit de l’appelant. Préférez les Type.GetType méthodes avec un assemblyResolver argument.
Assembly.GetType	Si le type name décrit un type générique qualifié d’assembly, déclenchez un Load-by-name.	Déduit de l’appelant. Préférez utiliser Type.GetType des noms de types qualifiés d’assembly.
Activator.CreateInstance(String, String) Activator.CreateInstance(String, String, Object[]) Activator.CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Load-by-name.	Déduit de l’appelant. Préférez les Activator.CreateInstance méthodes prenant un Type argument.

Algorithme

L’algorithme suivant décrit comment le runtime charge un assembly managé.

1. Déterminez le activeAssemblyLoadContext.

   • Pour une référence d’assembly statique, il s’agit activeAssemblyLoadContext de l’instance qui a chargé l’assembly de référence.
   • Les API préférées rendent l’élément activeAssemblyLoadContext explicite.
   • D’autres API déduitnt le activeAssemblyLoadContext. Pour ces API, la AssemblyLoadContext.CurrentContextualReflectionContext propriété est utilisée. Si sa valeur est null, l’instance déduite AssemblyLoadContext est utilisée.
   • Consultez le tableau dans la section Quand les assemblys managés sont-ils chargés ?

2. Pour les Load-by-name méthodes, le activeAssemblyLoadContext chargement de l’assembly dans l’ordre de priorité suivant :

   • Vérifiez son cache-by-name.
   • Appelez la fonction AssemblyLoadContext.Load.
   • Vérifiez le cache de l’instance et exécutez la AssemblyLoadContext.Default logique de détection par défaut de l’assembly managé . Si un assembly est récemment chargé, une référence est ajoutée aux AssemblyLoadContext.Default instances cache-by-name.
   • Déclenchez l’événement AssemblyLoadContext.Resolving pour l’assemblyLoadContext actif.
   • Déclenchez l'événement AppDomain.AssemblyResolve.

3. Pour les autres types de chargements, l’assembly activeAssemblyLoadContext est chargé dans l’ordre de priorité suivant :

   • Vérifiez son cache-by-name.
   • Chargez à partir du chemin d’accès spécifié ou de l’objet d’assembly brut. Si un assembly est récemment chargé, une référence est ajoutée aux activeAssemblyLoadContext instances cache-by-name.

4. Dans les deux cas, si un assembly est nouvellement chargé, l’événement AppDomain.AssemblyLoad est déclenché.