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

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

Ключевое слово для вызова события	Событие	Уровень
LoaderKeyword (0x8)	DomainModuleLoad_V1	Информационный (4)

Событие	Идентификатор события	Description
DomainModuleLoad_V1	151	Вызывается при загрузке модуля для домена приложения.

Событие ModuleLoad_V2

Ключевое слово для вызова события	Событие	Уровень
LoaderKeyword (0x8)	DomainModuleLoad_V1	Информационный (4)

Событие	Идентификатор события	Description
ModuleLoad_V2	152	Вызывается при загрузке модуля в течение времени существования процесса.

Имя поля	Тип данных	Description
ModuleID	win:UInt64	Уникальный идентификатор модуля.
AssemblyID	win:UInt64	Идентификатор сборки, в которой находится этот модуль.
ModuleFlags	win:UInt32	0x1: модуль, не зависящий от домена. 0x2: модуль с образом в машинном коде. 0x4: динамический модуль. 0x8: модуль манифеста.
Reserved1	win:UInt32	Зарезервированное поле.
ModuleILPath	win:UnicodeString	Путь к образу языка CIL для модуля или имя динамического модуля, если это динамическая сборка (строка, заканчивающаяся нулем).
ModuleNativePath	win:UnicodeString	Путь к образу модуля в машинном коде, если существует (строка, заканчивающаяся нулем).
ClrInstanceID	win:UInt16	Уникальный идентификатор экземпляра CLR или CoreCLR.
ManagedPdbSignature	win:GUID	Подпись GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge	win:UInt32	Значение возраста, записанное в управляемую базу данных программы, соответствующую этому модулю.
ManagedPdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка управляемой базы данных программы, соответствующей этому модулю. В некоторых случаях это просто имя файла.
NativePdbSignature	win:GUID	Подпись GUID базы данных программы для средства создания машинных образов (NGen), соответствующая этому модулю, если применимо.
NativePdbAge	win:UInt32	Значение возраста, записанное в базе данных программы NGen, соответствующей этому модулю, если применимо.
NativePdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка базы данных программы NGen, соответствующей этому модулю, если применимо. В некоторых случаях это просто имя файла.

Событие ModuleUnload_V2

Ключевое слово для вызова события	Событие	Уровень
LoaderKeyword (0x8)	DomainModuleLoad_V1	Информационный (4)

Событие	Идентификатор события	Description
ModuleUnload_V2	153	Вызывается при выгрузке модуля в течение времени существования процесса.

Имя поля	Тип данных	Description
ModuleID	win:UInt64	Уникальный идентификатор модуля.
AssemblyID	win:UInt64	Идентификатор сборки, в которой находится этот модуль.
ModuleFlags	win:UInt32	0x1: модуль, не зависящий от домена. 0x2: модуль с образом в машинном коде. 0x4: динамический модуль. 0x8: модуль манифеста.
Reserved1	win:UInt32	Зарезервированное поле.
ModuleILPath	win:UnicodeString	Путь к образу языка CIL для модуля или имя динамического модуля, если это динамическая сборка (строка, заканчивающаяся нулем).
ModuleNativePath	win:UnicodeString	Путь к образу модуля в машинном коде, если существует (строка, заканчивающаяся нулем).
ClrInstanceID	win:UInt16	Уникальный идентификатор экземпляра CLR или CoreCLR.
ManagedPdbSignature	win:GUID	Подпись GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge	win:UInt32	Значение возраста, записанное в управляемую базу данных программы, соответствующую этому модулю.
ManagedPdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка управляемой базы данных программы, соответствующей этому модулю. В некоторых случаях это просто имя файла.
NativePdbSignature	win:GUID	Подпись GUID базы данных программы для средства создания машинных образов (NGen), соответствующая этому модулю, если применимо.
NativePdbAge	win:UInt32	Значение возраста, записанное в базе данных программы NGen, соответствующей этому модулю, если применимо.
NativePdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка базы данных программы NGen, соответствующей этому модулю, если применимо. В некоторых случаях это просто имя файла.

Событие ModuleDCStart_V2

Ключевое слово для вызова события	Событие	Уровень
LoaderKeyword (0x8)	DomainModuleLoad_V1	Информационный (4)

Событие	Идентификатор события	Description
ModuleDCStart_V2	153	Перечисляет модули во время очистки запуска.

Имя поля	Тип данных	Description
ModuleID	win:UInt64	Уникальный идентификатор модуля.
AssemblyID	win:UInt64	Идентификатор сборки, в которой находится этот модуль.
ModuleFlags	win:UInt32	0x1: модуль, не зависящий от домена. 0x2: модуль с образом в машинном коде. 0x4: динамический модуль. 0x8: модуль манифеста.
Reserved1	win:UInt32	Зарезервированное поле.
ModuleILPath	win:UnicodeString	Путь к образу языка CIL для модуля или имя динамического модуля, если это динамическая сборка (строка, заканчивающаяся нулем).
ModuleNativePath	win:UnicodeString	Путь к образу модуля в машинном коде, если существует (строка, заканчивающаяся нулем).
ClrInstanceID	win:UInt16	Уникальный идентификатор экземпляра CLR или CoreCLR.
ManagedPdbSignature	win:GUID	Подпись GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge	win:UInt32	Значение возраста, записанное в управляемую базу данных программы, соответствующую этому модулю.
ManagedPdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка управляемой базы данных программы, соответствующей этому модулю. В некоторых случаях это просто имя файла.
NativePdbSignature	win:GUID	Подпись GUID базы данных программы для средства создания машинных образов (NGen), соответствующая этому модулю, если применимо.
NativePdbAge	win:UInt32	Значение возраста, записанное в базе данных программы NGen, соответствующей этому модулю, если применимо.
NativePdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка базы данных программы NGen, соответствующей этому модулю, если применимо. В некоторых случаях это просто имя файла.

Событие ModuleDCEnd_V2

Ключевое слово для вызова события	Событие	Уровень
LoaderKeyword (0x8)	DomainModuleLoad_V1	Информационный (4)

Событие	Идентификатор события	Description
ModuleDCEnd_V2	154	Перечисляет модули во время очистки завершения.

Имя поля	Тип данных	Description
ModuleID	win:UInt64	Уникальный идентификатор модуля.
AssemblyID	win:UInt64	Идентификатор сборки, в которой находится этот модуль.
ModuleFlags	win:UInt32	0x1: модуль, не зависящий от домена. 0x2: модуль с образом в машинном коде. 0x4: динамический модуль. 0x8: модуль манифеста.
Reserved1	win:UInt32	Зарезервированное поле.
ModuleILPath	win:UnicodeString	Путь к образу языка CIL для модуля или имя динамического модуля, если это динамическая сборка (строка, заканчивающаяся нулем).
ModuleNativePath	win:UnicodeString	Путь к образу модуля в машинном коде, если существует (строка, заканчивающаяся нулем).
ClrInstanceID	win:UInt16	Уникальный идентификатор экземпляра CLR или CoreCLR.
ManagedPdbSignature	win:GUID	Подпись GUID управляемой базы данных программы (PDB), которая соответствует этому модулю.
ManagedPdbAge	win:UInt32	Значение возраста, записанное в управляемую базу данных программы, соответствующую этому модулю.
ManagedPdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка управляемой базы данных программы, соответствующей этому модулю. В некоторых случаях это просто имя файла.
NativePdbSignature	win:GUID	Подпись GUID базы данных программы для средства создания машинных образов (NGen), соответствующая этому модулю, если применимо.
NativePdbAge	win:UInt32	Значение возраста, записанное в базе данных программы NGen, соответствующей этому модулю, если применимо.
NativePdbBuildPath	win:UnicodeString	Путь к расположению, где была выполнена сборка базы данных программы NGen, соответствующей этому модулю, если применимо. В некоторых случаях это просто имя файла.

Событие AssemblyLoad_V1

Ключевое слово для вызова события	Событие	Уровень
LoaderKeyword (0x8)	DomainModuleLoad_V1	Информационный (4)

Событие	Идентификатор события	Description
AssemblyLoad_V1	154	Наступает, когда сборка загружается.

Имя поля	Тип данных	Description
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)

Событие	Идентификатор события	Description
FireAssemblyUnload_V1	155	Наступает, когда сборка загружается.

Имя поля	Тип данных	Description
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)

Событие	Идентификатор события	Description
AssemblyDCStart_V1	155	Перечисляет сборки во время очистки запуска.

Имя поля	Тип данных	Description
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)

Событие	Идентификатор события	Description
AssemblyLoadStart	290	Запрошена загрузка сборки.

Имя поля	Тип данных	Description
AssemblyName	win:UnicodeString	Имя имени сборки.
AssemblyPath	win:UnicodeString	Путь имени сборки.
RequestingAssembly	win:UnicodeString	Имя запрашивающей ("родительской") сборки.
AssemblyLoadContext	win:UnicodeString	Контекст загрузки сборки.
RequestingAssemblyLoadContext	win:UnicodeString	Контекст загрузки запрашивающей ("родительской") сборки.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadStop

Ключевое слово для вызова события	Событие	Уровень
Binder (0x4)	AssemblyLoadStart	Информационный (4)

Событие	Идентификатор события	Description
AssemblyLoadStart	291	Запрошена загрузка сборки.

Имя поля	Тип данных	Description
AssemblyName	win:UnicodeString	Имя имени сборки.
AssemblyPath	win:UnicodeString	Путь имени сборки.
RequestingAssembly	win:UnicodeString	Имя запрашивающей ("родительской") сборки.
AssemblyLoadContext	win:UnicodeString	Контекст загрузки сборки.
RequestingAssemblyLoadContext	win:UnicodeString	Контекст загрузки запрашивающей ("родительской") сборки.
Success	win:Boolean	Была ли загрузка сборки успешной.
ResultAssemblyName	win:UnicodeString	Имя загруженной сборки.
ResultAssemblyPath	win:UnicodeString	Имя сборки, из которой была выполнена загрузка.
Cached	win:UnicodeString	Была ли загрузка кэширована.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.

Событие ResolutionAttempted

Ключевое слово для вызова события	Уровень
Binder (0x4)	Информационный (4)

Событие	Идентификатор события	Description
ResolutionAttempted	292	Запрошена загрузка сборки.

Имя поля	Тип данных	Description
AssemblyName	win:UnicodeString	Имя имени сборки.
Stage	win:UInt16	Этап разрешения. 0: найти в загрузке. 1. Контекст загрузки сборки 2: сборки приложения. 3: откат контекста загрузки сборки по умолчанию. 4: разрешение вспомогательной сборки. 5: разрешение контекста загрузки сборки. 6: разрешение сборки AppDomain.
AssemblyLoadContext	win:UnicodeString	Контекст загрузки сборки.
Result	win:UInt16	Результат попытки разрешения. 0: успешное завершение 1: сборка не найдена 2: несовместимая версия 3: несовпадение имени сборки 4: сбой 5: исключение
ResultAssemblyName	win:UnicodeString	Имя разрешенной сборки.
ResultAssemblyPath	win:UnicodeString	Путь сборки, из которой было выполнено разрешение.
ErrorMessage	win:UnicodeString	Сообщение об ошибке при исключении.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadContextResolvingHandlerInvoked

Ключевое слово для вызова события	Уровень
Binder (0x4)	Информационный (4)

Событие	Идентификатор события	Description
AssemblyLoadContextResolvingHandlerInvoked	293	Вызван обработчик AssemblyLoadContext.Resolving.

Имя поля	Тип данных	Description
AssemblyName	win:UnicodeString	Имя имени сборки.
HandlerName	win:UnicodeString	Имя вызванного обработчика.
AssemblyLoadContext	win:UnicodeString	Контекст загрузки сборки.
ResultAssemblyName	win:UnicodeString	Имя разрешенной сборки.
ResultAssemblyPath	win:UnicodeString	Путь сборки, из которой было выполнено разрешение.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.

Событие AppDomainAssemblyResolveHandlerInvoked

Ключевое слово для вызова события	Уровень
Binder (0x4)	Информационный (4)

Событие	Идентификатор события	Description
AppDomainAssemblyResolveHandlerInvoked	294	Вызван обработчик AppDomain.AssemblyResolve.

Имя поля	Тип данных	Description
AssemblyName	win:UnicodeString	Имя имени сборки.
HandlerName	win:UnicodeString	Имя вызванного обработчика.
ResultAssemblyName	win:UnicodeString	Имя разрешенной сборки.
ResultAssemblyPath	win:UnicodeString	Путь сборки, из которой было выполнено разрешение.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.

Событие AssemblyLoadFromResolveHandlerInvoked

Ключевое слово для вызова события	Уровень
Binder (0x4)	Информационный (4)

Событие	Идентификатор события	Description
AssemblyLoadFromResolveHandlerInvoked	295	Вызван обработчик Assembly.LoadFrom.

Имя поля	Тип данных	Description
AssemblyName	win:UnicodeString	Имя имени сборки.
IsTrackedLoad	win:Boolean	Указывает, выполняется ли отслеживание загрузки сборки.
RequestingAssemblyPath	win:UnicodeString	Путь запрашивающей сборки.
ComputedRequestedAssemblyPath	win:UnicodeString	Путь сборки, которая была запрошена.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.

Событие KnownPathProbed

Ключевое слово для вызова события	Уровень
Binder (0x4)	Информационный (4)

Событие	Идентификатор события	Description
KnownPathProbed	296	Для сборки был проверен известный путь.

Имя поля	Тип данных	Description
FilePath	win:UnicodeString	Путь опробован.
Source	win:UInt16	Источник опробованного пути. 0x0: сборки приложения. 0x1: путь к образу в собственном коде приложения. 0x2:App path. 0x3: корневые элементы ресурсов платформы. 0x4:Вспомогательный подкаталог.
Result	win:UInt32	HRESULT для пробы.
ClrInstanceID	win:UInt16	Уникальный идентификатор для экземпляра CoreCLR.