Поделиться через


События загрузчика и привязки среды выполнения .NET

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

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
DomainModuleLoad_V1 151 Вызывается при загрузке модуля для домена приложения.

событие ModuleLoad_V2

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
ModuleLoad_V2 152 Вызывается при загрузке модуля во время существования процесса.
Имя поля Тип данных Описание
ModuleID win:UInt64 Уникальный идентификатор модуля.
AssemblyID win:UInt64 Идентификатор сборки, в которой находится этот модуль.
ModuleFlags win:UInt32 0x1: нейтральный модуль домена.

0x2: модуль имеет собственный образ.

0x4: динамический модуль.

0x8: модуль манифеста.
Reserved1 win:UInt32 Зарезервированное поле.
ModuleILPath win:UnicodeString Путь образа common Intermediate Language (CIL) для модуля или динамического имени модуля, если это динамическая сборка (завершаемая значение NULL).
ModuleNativePath win:UnicodeString Путь к собственному изображению модуля, если он присутствует (значение NULL- завершается).
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра СРЕДЫ CLR или CoreCLR.
ManagedPdbSignature win:GUID Сигнатура GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge win:UInt32 Номер возраста, записанный в управляемый PDB, соответствующий этому модулю.
ManagedPdbBuildPath win:UnicodeString Путь к расположению, в котором создан управляемый PDB, соответствующий этому модулю. В некоторых случаях это может быть просто имя файла.
NativePdbSignature win:GUID Сигнатура GUID собственного генератора образов (NGen), которая соответствует этому модулю, если применимо.
NativePdbAge win:UInt32 Номер возраста, записанный в NGen PDB, соответствующий этому модулю, если применимо.
NativePdbBuildPath win:UnicodeString Путь к расположению, в котором создан NGen PDB, соответствующий этому модулю, при необходимости. В некоторых случаях это может быть просто имя файла.

событие ModuleUnload_V2

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
ModuleUnload_V2 153 Вызывается при выгрузке модуля во время существования процесса.
Имя поля Тип данных Описание
ModuleID win:UInt64 Уникальный идентификатор модуля.
AssemblyID win:UInt64 Идентификатор сборки, в которой находится этот модуль.
ModuleFlags win:UInt32 0x1: нейтральный модуль домена.

0x2: модуль имеет собственный образ.

0x4: динамический модуль.

0x8: модуль манифеста.
Reserved1 win:UInt32 Зарезервированное поле.
ModuleILPath win:UnicodeString Путь образа common Intermediate Language (CIL) для модуля или динамического имени модуля, если это динамическая сборка (завершаемая значение NULL).
ModuleNativePath win:UnicodeString Путь к собственному изображению модуля, если он присутствует (значение NULL- завершается).
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра СРЕДЫ CLR или CoreCLR.
ManagedPdbSignature win:GUID Сигнатура GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge win:UInt32 Номер возраста, записанный в управляемый PDB, соответствующий этому модулю.
ManagedPdbBuildPath win:UnicodeString Путь к расположению, в котором создан управляемый PDB, соответствующий этому модулю. В некоторых случаях это может быть просто имя файла.
NativePdbSignature win:GUID Сигнатура GUID собственного генератора образов (NGen), которая соответствует этому модулю, если применимо.
NativePdbAge win:UInt32 Номер возраста, записанный в NGen PDB, соответствующий этому модулю, если применимо.
NativePdbBuildPath win:UnicodeString Путь к расположению, в котором создан NGen PDB, соответствующий этому модулю, при необходимости. В некоторых случаях это может быть просто имя файла.

событие ModuleDCStart_V2

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
ModuleDCStart_V2 153 Перечисляет модули во время запуска запуска.
Имя поля Тип данных Описание
ModuleID win:UInt64 Уникальный идентификатор модуля.
AssemblyID win:UInt64 Идентификатор сборки, в которой находится этот модуль.
ModuleFlags win:UInt32 0x1: нейтральный модуль домена.

0x2: модуль имеет собственный образ.

0x4: динамический модуль.

0x8: модуль манифеста.
Reserved1 win:UInt32 Зарезервированное поле.
ModuleILPath win:UnicodeString Путь образа common Intermediate Language (CIL) для модуля или динамического имени модуля, если это динамическая сборка (завершаемая значение NULL).
ModuleNativePath win:UnicodeString Путь к собственному изображению модуля, если он присутствует (значение NULL- завершается).
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра СРЕДЫ CLR или CoreCLR.
ManagedPdbSignature win:GUID Сигнатура GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge win:UInt32 Номер возраста, записанный в управляемый PDB, соответствующий этому модулю.
ManagedPdbBuildPath win:UnicodeString Путь к расположению, в котором создан управляемый PDB, соответствующий этому модулю. В некоторых случаях это может быть просто имя файла.
NativePdbSignature win:GUID Сигнатура GUID собственного генератора образов (NGen), которая соответствует этому модулю, если применимо.
NativePdbAge win:UInt32 Номер возраста, записанный в NGen PDB, соответствующий этому модулю, если применимо.
NativePdbBuildPath win:UnicodeString Путь к расположению, в котором создан NGen PDB, соответствующий этому модулю, при необходимости. В некоторых случаях это может быть просто имя файла.

событие ModuleDCEnd_V2

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
ModuleDCEnd_V2 154 Перечисляет модули во время завершения запуска.
Имя поля Тип данных Описание
ModuleID win:UInt64 Уникальный идентификатор модуля.
AssemblyID win:UInt64 Идентификатор сборки, в которой находится этот модуль.
ModuleFlags win:UInt32 0x1: нейтральный модуль домена.

0x2: модуль имеет собственный образ.

0x4: динамический модуль.

0x8: модуль манифеста.
Reserved1 win:UInt32 Зарезервированное поле.
ModuleILPath win:UnicodeString Путь образа common Intermediate Language (CIL) для модуля или динамического имени модуля, если это динамическая сборка (завершаемая значение NULL).
ModuleNativePath win:UnicodeString Путь к собственному изображению модуля, если он присутствует (значение NULL- завершается).
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра СРЕДЫ CLR или CoreCLR.
ManagedPdbSignature win:GUID Сигнатура GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge win:UInt32 Номер возраста, записанный в управляемый PDB, соответствующий этому модулю.
ManagedPdbBuildPath win:UnicodeString Путь к расположению, в котором создан управляемый PDB, соответствующий этому модулю. В некоторых случаях это может быть просто имя файла.
NativePdbSignature win:GUID Сигнатура GUID собственного генератора образов (NGen), которая соответствует этому модулю, если применимо.
NativePdbAge win:UInt32 Номер возраста, записанный в NGen PDB, соответствующий этому модулю, если применимо.
NativePdbBuildPath win:UnicodeString Путь к расположению, в котором создан NGen PDB, соответствующий этому модулю, при необходимости. В некоторых случаях это может быть просто имя файла.

событие AssemblyLoad_V1

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
AssemblyLoad_V1 154 Вызывается при загрузке сборки.
Имя поля Тип данных Описание
AssemblyID win:UInt64 Уникальный идентификатор сборки.
AppDomainID win:UInt64 Идентификатор домена этой сборки.
BindingID win:UInt64 Идентификатор, который однозначно идентифицирует привязку сборки.
AssemblyFlags win:UInt32 0x1: нейтральная сборка домена.

0x2: динамическая сборка.

0x4: сборка имеет собственный образ.

0x8: сборная сборка.
AssemblyName win:UnicodeString Полное имя сборки.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

событие AssemblyUnload_V1

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
FireAssemblyUnload_V1 155 Вызывается при загрузке сборки.
Имя поля Тип данных Описание
AssemblyID win:UInt64 Уникальный идентификатор сборки.
AppDomainID win:UInt64 Идентификатор домена этой сборки.
BindingID win:UInt64 Идентификатор, который однозначно идентифицирует привязку сборки.
AssemblyFlags win:UInt32 0x1: нейтральная сборка домена.

0x2: динамическая сборка.

0x4: сборка имеет собственный образ.

0x8: сборная сборка.
AssemblyName win:UnicodeString Полное имя сборки.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

событие AssemblyDCStart_V1

Ключевое слово для вызова события Событие Уровень
LoaderKeyword (0x8) DomainModuleLoad_V1 Информационные (4)
Событие Идентификатор события Описание
AssemblyDCStart_V1 155 Перечисляет сборки во время запуска запуска.
Имя поля Тип данных Описание
AssemblyID win:UInt64 Уникальный идентификатор сборки.
AppDomainID win:UInt64 Идентификатор домена этой сборки.
BindingID win:UInt64 Идентификатор, который однозначно идентифицирует привязку сборки.
AssemblyFlags win:UInt32 0x1: нейтральная сборка домена.

0x2: динамическая сборка.

0x4: сборка имеет собственный образ.

0x8: сборная сборка.
AssemblyName win:UnicodeString Полное имя сборки.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadStart

Ключевое слово для вызова события Событие Уровень
Binder (0x4) AssemblyLoadStart Информационные (4)
Событие Идентификатор события Описание
AssemblyLoadStart 290 Запрошена загрузка сборки.
Имя поля Тип данных Описание
AssemblyName win:UnicodeString Имя сборки.
AssemblyPath win:UnicodeString Путь к имени сборки.
RequestingAssembly win:UnicodeString Имя запрашивающей сборки (parent).
AssemblyLoadContext win:UnicodeString Контекст загрузки сборки.
RequestingAssemblyLoadContext win:UnicodeString Контекст загрузки сборки запроса (parent).
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadStop

Ключевое слово для вызова события Событие Уровень
Binder (0x4) AssemblyLoadStart Информационные (4)
Событие Идентификатор события Описание
AssemblyLoadStart 291 Запрошена загрузка сборки.
Имя поля Тип данных Описание
AssemblyName win:UnicodeString Имя сборки.
AssemblyPath win:UnicodeString Путь к имени сборки.
RequestingAssembly win:UnicodeString Имя запрашивающей сборки (parent).
AssemblyLoadContext win:UnicodeString Контекст загрузки сборки.
RequestingAssemblyLoadContext win:UnicodeString Контекст загрузки сборки запроса (parent).
Success win:Boolean Успешно ли выполнена загрузка сборки.
ResultAssemblyName win:UnicodeString Имя загруженной сборки.
ResultAssemblyPath win:UnicodeString Путь к сборке, загруженной из.
Cached win:UnicodeString Кэширована ли загрузка.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие ResolutionAttempted

Ключевое слово для вызова события Уровень
Binder (0x4) Информационные (4)
Событие Идентификатор события Описание
ResolutionAttempted 292 Запрошена загрузка сборки.
Имя поля Тип данных Описание
AssemblyName win:UnicodeString Имя сборки.
Stage win:UInt16 Этап разрешения.

0. Поиск в нагрузке.

1. Контекст загрузки сборки

2. Сборки приложений.

3. Резервное восстановление контекста загрузки сборки по умолчанию.

4. Разрешение вспомогательной сборки.

5. Разрешение контекста загрузки сборки.

6. Разрешение сборки AppDomain.
AssemblyLoadContext win:UnicodeString Контекст загрузки сборки.
Result win:UInt16 Результат попытки разрешения.

0. Успех

1. Сборка NotFound

2. Несовместимая версия

3. Несоответствие имени сборки

4. Сбой

5. Исключение
ResultAssemblyName win:UnicodeString Имя разрешенной сборки.
ResultAssemblyPath win:UnicodeString Путь к сборке, из которую был разрешен.
ErrorMessage win:UnicodeString Сообщение об ошибке, если существует исключение.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadContextResolvingHandlerInvoked

Ключевое слово для вызова события Уровень
Binder (0x4) Информационные (4)
Событие Идентификатор события Описание
AssemblyLoadContextResolvingHandlerInvoked 293 Вызывается обработчик AssemblyLoadContext.Resolving.
Имя поля Тип данных Описание
AssemblyName win:UnicodeString Имя сборки.
HandlerName win:UnicodeString Имя вызываемого обработчика.
AssemblyLoadContext win:UnicodeString Контекст загрузки сборки.
ResultAssemblyName win:UnicodeString Имя разрешенной сборки.
ResultAssemblyPath win:UnicodeString Путь к сборке, из которую был разрешен.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие AppDomainAssemblyResolveHandlerInvoked

Ключевое слово для вызова события Уровень
Binder (0x4) Информационные (4)
Событие Идентификатор события Описание
AppDomainAssemblyResolveHandlerInvoked 294 Вызывается обработчик AppDomain.AssemblyResolve.
Имя поля Тип данных Описание
AssemblyName win:UnicodeString Имя сборки.
HandlerName win:UnicodeString Имя вызываемого обработчика.
ResultAssemblyName win:UnicodeString Имя разрешенной сборки.
ResultAssemblyPath win:UnicodeString Путь к сборке, из которую был разрешен.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadFromResolveHandlerInvoked

Ключевое слово для вызова события Уровень
Binder (0x4) Информационные (4)
Событие Идентификатор события Описание
AssemblyLoadFromResolveHandlerInvoked 295 Вызывается обработчик Assembly.LoadFrom.
Имя поля Тип данных Описание
AssemblyName win:UnicodeString Имя сборки.
IsTrackedLoad win:Boolean Отслеживается ли загрузка сборки.
RequestingAssemblyPath win:UnicodeString Путь к запрашивающей сборке.
ComputedRequestedAssemblyPath win:UnicodeString Путь к запрошенной сборке.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.

Событие KnownPathProbed

Ключевое слово для вызова события Уровень
Binder (0x4) Информационные (4)
Событие Идентификатор события Описание
KnownPathProbed 296 Известный путь был проверен для сборки.
Имя поля Тип данных Описание
FilePath win:UnicodeString Путь пробирован.
Source win:UInt16 Источник пробного пути.

0x0:Сборки приложений.

0x1:App native image path.

0x2:App path.

0x3:Платформа корней ресурсов.

0x4:Вспомогательный подкаталог.
Result win:UInt32 HRESULT для пробы.
ClrInstanceID win:UInt16 Уникальный идентификатор для экземпляра CoreCLR.