Algoritmo di caricamento dell'assembly gestito

Gli assembly gestiti vengono posizionati e caricati con un algoritmo che prevede varie fasi.

Tutti gli assembly gestiti, ad eccezione degli assembly satellite e degli assembly WinRT, usano lo stesso algoritmo.

Quando vengono caricati gli assembly gestiti?

Il meccanismo più comune per attivare un carico di assembly gestito è un riferimento all'assembly statico. Questi riferimenti vengono inseriti dal compilatore ogni volta che il codice usa un tipo definito in un altro assembly. Questi assembly vengono caricati (load-by-name) in base alle esigenze del runtime. L'intervallo esatto di quando vengono caricati i riferimenti all'assembly statico non è specificato. Può variare tra una versione e l’altra di runtime e dipende da ottimizzazioni come l'inlining.

Anche l'uso diretto delle API seguenti attiverà i caricamenti:

API	Descrizione	Active AssemblyLoadContext
AssemblyLoadContext.LoadFromAssemblyName	Load-by-name	La presente istanza.
AssemblyLoadContext.LoadFromAssemblyPath AssemblyLoadContext.LoadFromNativeImagePath	Caricare dal percorso.	La presente istanza.
AssemblyLoadContext.LoadFromStream	Caricare dall'oggetto.	La presente istanza.
Assembly.LoadFile	Caricare dal percorso in una nuova istanza AssemblyLoadContext	Nuova istanza di AssemblyLoadContext.
Assembly.LoadFrom	Caricare dal percorso nell'istanza AssemblyLoadContext.Default. Aggiunge un gestore AppDomain.AssemblyResolve. Il gestore caricherà le dipendenze dell'assembly dalla relativa directory.	Istanza AssemblyLoadContext.Default.
Assembly.Load(AssemblyName) Assembly.Load(String) Assembly.LoadWithPartialName	Load-by-name.	Dedotto dal chiamante. Preferisce i metodi AssemblyLoadContext.
Assembly.Load(Byte[]) Assembly.Load(Byte[], Byte[])	Caricare dall'oggetto in una nuova istanza AssemblyLoadContext.	Nuova istanza di AssemblyLoadContext.
Type.GetType(String) Type.GetType(String, Boolean) Type.GetType(String, Boolean, Boolean)	Load-by-name.	Dedotto dal chiamante. Preferisce i metodi Type.GetType con un argomento assemblyResolver.
Assembly.GetType	Se il tipo name descrive un tipo generico qualificato di assembly, attivare un Load-by-name.	Dedotto dal chiamante. Preferire Type.GetType quando si usano nomi di tipi qualificati dell'assembly.
Activator.CreateInstance(String, String) Activator.CreateInstance(String, String, Object[]) Activator.CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Load-by-name.	Dedotto dal chiamante. Preferisce i metodi Activator.CreateInstance che accettano un argomento Type.

Algoritmo

L'algoritmo seguente descrive come il runtime carica un assembly gestito.

1. Determinare active AssemblyLoadContext.

   • Per un riferimento all'assembly statico, activeAssemblyLoadContext è l'istanza che ha caricato l'assembly di riferimento.
   • Le API preferite rendono esplicito active AssemblyLoadContext.
   • Altre API deducono active AssemblyLoadContext. Per queste API, viene usata la proprietà AssemblyLoadContext.CurrentContextualReflectionContext. Se il valore è null, viene usata l'istanza dedotta AssemblyLoadContext.
   • Vedere la tabella nella sezione Quando vengono caricati assembly gestiti?.

2. Per i metodi Load-by-name, active AssemblyLoadContext carica l'assembly nell'ordine di priorità seguente:

   • Controllare il relativo cache-by-name.
   • Chiamare la funzione AssemblyLoadContext.Load.
   • Controllare la cache dell'istanza di AssemblyLoadContext.Default ed eseguire la logica di verifica predefinita dell'assembly gestito. Se un assembly viene appena caricato, viene aggiunto un riferimento a cache-by-namedell'istanza AssemblyLoadContext.Default.
   • Generare l'evento AssemblyLoadContext.Resolving per AssemblyLoadContext attivo.
   • Generare l'evento AppDomain.AssemblyResolve.

3. Per gli altri tipi di caricamento, active AssemblyLoadContext carica l'assembly nell'ordine di priorità seguente:

   • Controllare il relativo cache-by-name.
   • Caricare dal percorso specificato o dall'oggetto assembly non elaborato. Se viene caricato un nuovo assembly, si aggiunge un riferimento a active AssemblyLoadContext cache-by-name dell'istanza.

4. In entrambi i casi, se un assembly viene appena caricato, viene generato l'evento AppDomain.AssemblyLoad.