Алгоритм загрузки управляемых сборок

Управляемые сборки находятся и загружаются с помощью алгоритма с различными этапами.

Для всех управляемых сборок, за исключением вспомогательных сборок и сборок WinRT, используется один и тот же алгоритм.

Когда загружаются управляемые сборки?

Чаще всего загрузку управляемой сборки активирует статическая ссылка на сборку. Эти ссылки добавляются в компилятор каждый раз, когда код обращается к типу, который определен в другой сборке. Такие сборки среда выполнения загружает (load-by-name) по мере необходимости. Точное время загрузки ссылок на статические сборки не определено. Она может отличаться от версий среды выполнения и зависит от оптимизаций, таких как встраивание.

Прямое использование следующих API также активирует нагрузки:

API	Description	Active AssemblyLoadContext
AssemblyLoadContext.LoadFromAssemblyName	Load-by-name	Экземпляр this.
AssemblyLoadContext.LoadFromAssemblyPath AssemblyLoadContext.LoadFromNativeImagePath	Загрузка на основе пути.	Экземпляр this.
AssemblyLoadContext.LoadFromStream	Загрузка из объекта.	Экземпляр this.
Assembly.LoadFile	Загрузка на основе пути в новый экземпляр AssemblyLoadContext.	Новый экземпляр AssemblyLoadContext.
Assembly.LoadFrom	Загрузка на основе пути в новый экземпляр AssemblyLoadContext.Default. AppDomain.AssemblyResolve Добавляет обработчик. Обработчик загрузит зависимости сборки из своего каталога.	Экземпляр AssemblyLoadContext.Default.
Assembly.Load(AssemblyName) Assembly.Load(String) Assembly.LoadWithPartialName	Load-by-name.	Выводится из вызывающего объекта. Лучше использовать методы AssemblyLoadContext.
Assembly.Load(Byte[]) Assembly.Load(Byte[], Byte[])	Загрузка из объекта в новый экземпляр AssemblyLoadContext.	Новый экземпляр AssemblyLoadContext.
Type.GetType(String) Type.GetType(String, Boolean) Type.GetType(String, Boolean, Boolean)	Load-by-name.	Выводится из вызывающего объекта. Лучше использовать методы Type.GetType с аргументом assemblyResolver.
Assembly.GetType	Если в типе name описан полный универсальный тип сборки, активируется Load-by-name.	Выводится из вызывающего объекта. Лучше использовать Type.GetType для полных имен типов сборки.
Activator.CreateInstance(String, String) Activator.CreateInstance(String, String, Object[]) Activator.CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Load-by-name.	Выводится из вызывающего объекта. Лучше использовать методы Activator.CreateInstance, принимающие аргумент Type.

Алгоритм

Ниже приведен алгоритм загрузки управляемой сборки средой выполнения.

1. Определяется active AssemblyLoadContext.

   • Для ссылки на статическую сборку active AssemblyLoadContext обозначает экземпляр, который загрузил ссылающуюся сборку.
   • Предпочитаемые API-интерфейсы делают экземпляр active AssemblyLoadContext явным.
   • Другие API-интерфейсы выводят active AssemblyLoadContext. Для этих API-интерфейсов используется свойство AssemblyLoadContext.CurrentContextualReflectionContext. Если его значение равно null, то используется выводимый экземпляр AssemblyLoadContext.
   • См. таблицу в разделе "Когда загружаются управляемые сборки?" .

2. Load-by-name Для методов сборка active AssemblyLoadContext загружается в следующем порядке приоритета:

   • Проверьте его cache-by-name.
   • Вызовите функцию AssemblyLoadContext.Load.
   • AssemblyLoadContext.Default Проверьте кэш экземпляра и запустите логику проверки по умолчанию управляемой сборки. Если сборка загружена впервые, добавляется соответствующая ссылка на cache-by-name экземпляра AssemblyLoadContext.Default.
   • AssemblyLoadContext.Resolving Вызов события для активного assemblyLoadContext.
   • AppDomain.AssemblyResolve Вызов события.

3. Для других типов загрузок active AssemblyLoadContext загружает сборку в следующем порядке приоритета:

   • Проверьте его cache-by-name.
   • Загружается из указанного пути или необработанного объекта сборки. Если сборка только что загружена, в экземпляр cache-by-nameдобавляется active AssemblyLoadContext ссылка.

4. В любом случае, если сборка только что загружена, AppDomain.AssemblyLoad возникает событие.