Managed assembly loading algorithm

本文内容

Managed assemblies are located and loaded with an algorithm involving various stages.

All managed assemblies except satellite assemblies and WinRT assemblies use the same algorithm.

When are managed assemblies loaded?

The most common mechanism to trigger a managed assembly load is a static assembly reference. These references are inserted by the compiler whenever code uses a type defined in another assembly. These assemblies are loaded (load-by-name) as needed by the runtime.

The direct use of specific APIs will also trigger loads:

API	Description	`Active` AssemblyLoadContext
AssemblyLoadContext.LoadFromAssemblyName	`Load-by-name`	The this instance.
AssemblyLoadContext.LoadFromAssemblyPath AssemblyLoadContext.LoadFromNativeImagePath	Load from path.	The this instance.
AssemblyLoadContext.LoadFromStream	Load from object.	The this instance.
Assembly.LoadFile	Load from path in a new AssemblyLoadContext instance	The new AssemblyLoadContext instance.
Assembly.LoadFrom	Load from path in the AssemblyLoadContext.Default instance.Adds a Resolving handler to AssemblyLoadContext.Default. The handler will load the assembly's dependencies from its directory.	The AssemblyLoadContext.Default instance.
Assembly.Load(AssemblyName)Assembly.Load(String)Assembly.LoadWithPartialName	`Load-by-name`.	Inferred from caller.Prefer AssemblyLoadContext methods.
Assembly.Load(Byte[])Assembly.Load(Byte[], Byte[])	Load from object.	Inferred from caller.Prefer AssemblyLoadContext methods.
Type.GetType(String)Type.GetType(String, Boolean)Type.GetType(String, Boolean, Boolean)	`Load-by-name`.	Inferred from caller.Prefer Type.GetType methods with an `assemblyResolver` argument.
Assembly.GetType	If type `name` describes an assembly qualified generic type, trigger a `Load-by-name`.	Inferred from caller.Prefer Type.GetType when using assembly qualified type names.
Activator.CreateInstance(String, String)Activator.CreateInstance(String, String, Object[])Activator.CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	`Load-by-name`.	Inferred from caller.Prefer Activator.CreateInstance methods taking a Type argument.

Algorithm

The following algorithm describes how the runtime loads a managed assembly.

Determine the active AssemblyLoadContext.
- For a static assembly reference, the active AssemblyLoadContext is the instance that loaded the referring assembly.
- Preferred APIs make the active AssemblyLoadContext explicit.
- Other APIs infer the active AssemblyLoadContext. For these APIs, the AssemblyLoadContext.CurrentContextualReflectionContext property is used. If its value is null, then the inferred AssemblyLoadContext instance is used.
- See table above.
For the Load-by-name methods, the active AssemblyLoadContext loads the assembly. In priority order by:
- Checking its cache-by-name.
- Calling the AssemblyLoadContext.Load function.
- Checking the AssemblyLoadContext.Default instances' cache and running managed assembly default probing logic.
- Raising the AssemblyLoadContext.Resolving event for the active AssemblyLoadContext.
- Raising the AppDomain.AssemblyResolve event.
For the other types of loads, the active AssemblyLoadContext loads the assembly. In priority order by:
- Checking its cache-by-name.
- Loading from the specified path or raw assembly object.
In either case, if an assembly is newly loaded, then:
- The AppDomain.AssemblyLoad event is raised.
- A reference is added to the assembly's AssemblyLoadContext instance's cache-by-name.
If the assembly is found, a reference is added as needed to the active AssemblyLoadContext instance's cache-by-name.

加载托管程序集

Managed assembly loading algorithm

本文内容

When are managed assemblies loaded?

Algorithm