Eventos de runtime do carregador e associador do .NET

Artigo
05/10/2023

Os eventos descritos nesse artigo coletam informações relacionadas ao carregamento e descarregamento de assemblies e módulos. Para saber como usar esses eventos para fins de diagnóstico, confira Registro em log e rastreamento de aplicativos .NET

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`DomainModuleLoad_V1`	151	Gerado quando um módulo é carregado para um domínio do aplicativo.

ModuleLoad_V2 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`ModuleLoad_V2`	152	Gerado quando um módulo é carregado durante o tempo de vida de um processo.

Nome do campo	Tipo de dados	Descrição
`ModuleID`	`win:UInt64`	ID exclusiva para o módulo.
`AssemblyID`	`win:UInt64`	ID do assembly em que esse módulo reside.
`ModuleFlags`	`win:UInt32`	0x1: módulo de domínio neutro. 0x2: o módulo tem uma imagem nativa. 0x4: módulo dinâmico. 0x8: módulo de manifesto.
`Reserved1`	`win:UInt32`	Campo reservado.
`ModuleILPath`	`win:UnicodeString`	O caminho da imagem CIL (Common Intermediate Language) para o módulo ou o nome de módulo dinâmico se ele for um assembly dinâmico (terminado em nulo).
`ModuleNativePath`	`win:UnicodeString`	Caminho da imagem nativa do módulo, se presente (terminado em nulo).
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CLR ou do CoreCLR.
`ManagedPdbSignature`	`win:GUID`	Assinatura GUID do banco de dados de programa (PDB) gerenciado que corresponde a esse módulo.
`ManagedPdbAge`	`win:UInt32`	Número de idade escrito para o PDB gerenciado que corresponde a esse módulo.
`ManagedPdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB gerenciado que corresponde a esse módulo foi criado. Em alguns casos, isso pode ser apenas um nome de arquivo.
`NativePdbSignature`	`win:GUID`	Assinatura GUID do gerador de imagem nativa (NGen) PDB que corresponde a esse módulo, se aplicável.
`NativePdbAge`	`win:UInt32`	Número de idade escrito para o PDB do NGen que corresponde a esse módulo, se aplicável.
`NativePdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB do NGen que corresponde a esse módulo foi criado, se aplicável. Em alguns casos, isso pode ser apenas um nome de arquivo.

ModuleUnload_V2 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`ModuleUnload_V2`	153	Gerado quando um módulo é descarregado durante o tempo de vida de um processo.

Nome do campo	Tipo de dados	Descrição
`ModuleID`	`win:UInt64`	ID exclusiva para o módulo.
`AssemblyID`	`win:UInt64`	ID do assembly em que esse módulo reside.
`ModuleFlags`	`win:UInt32`	0x1: módulo de domínio neutro. 0x2: o módulo tem uma imagem nativa. 0x4: módulo dinâmico. 0x8: módulo de manifesto.
`Reserved1`	`win:UInt32`	Campo reservado.
`ModuleILPath`	`win:UnicodeString`	O caminho da imagem CIL (Common Intermediate Language) para o módulo ou o nome de módulo dinâmico se ele for um assembly dinâmico (terminado em nulo).
`ModuleNativePath`	`win:UnicodeString`	Caminho da imagem nativa do módulo, se presente (terminado em nulo).
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CLR ou do CoreCLR.
`ManagedPdbSignature`	`win:GUID`	Assinatura GUID do banco de dados de programa (PDB) gerenciado que corresponde a esse módulo.
`ManagedPdbAge`	`win:UInt32`	Número de idade escrito para o PDB gerenciado que corresponde a esse módulo.
`ManagedPdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB gerenciado que corresponde a esse módulo foi criado. Em alguns casos, isso pode ser apenas um nome de arquivo.
`NativePdbSignature`	`win:GUID`	Assinatura GUID do gerador de imagem nativa (NGen) PDB que corresponde a esse módulo, se aplicável.
`NativePdbAge`	`win:UInt32`	Número de idade escrito para o PDB do NGen que corresponde a esse módulo, se aplicável.
`NativePdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB do NGen que corresponde a esse módulo foi criado, se aplicável. Em alguns casos, isso pode ser apenas um nome de arquivo.

ModuleDCStart_V2 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`ModuleDCStart_V2`	153	Enumera módulos durante um encerramento inicial.

Nome do campo	Tipo de dados	Descrição
`ModuleID`	`win:UInt64`	ID exclusiva para o módulo.
`AssemblyID`	`win:UInt64`	ID do assembly em que esse módulo reside.
`ModuleFlags`	`win:UInt32`	0x1: módulo de domínio neutro. 0x2: o módulo tem uma imagem nativa. 0x4: módulo dinâmico. 0x8: módulo de manifesto.
`Reserved1`	`win:UInt32`	Campo reservado.
`ModuleILPath`	`win:UnicodeString`	O caminho da imagem CIL (Common Intermediate Language) para o módulo ou o nome de módulo dinâmico se ele for um assembly dinâmico (terminado em nulo).
`ModuleNativePath`	`win:UnicodeString`	Caminho da imagem nativa do módulo, se presente (terminado em nulo).
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CLR ou do CoreCLR.
`ManagedPdbSignature`	`win:GUID`	Assinatura GUID do banco de dados de programa (PDB) gerenciado que corresponde a esse módulo.
`ManagedPdbAge`	`win:UInt32`	Número de idade escrito para o PDB gerenciado que corresponde a esse módulo.
`ManagedPdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB gerenciado que corresponde a esse módulo foi criado. Em alguns casos, isso pode ser apenas um nome de arquivo.
`NativePdbSignature`	`win:GUID`	Assinatura GUID do gerador de imagem nativa (NGen) PDB que corresponde a esse módulo, se aplicável.
`NativePdbAge`	`win:UInt32`	Número de idade escrito para o PDB do NGen que corresponde a esse módulo, se aplicável.
`NativePdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB do NGen que corresponde a esse módulo foi criado, se aplicável. Em alguns casos, isso pode ser apenas um nome de arquivo.

ModuleDCEnd_V2 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`ModuleDCEnd_V2`	154	Enumera módulos durante um encerramento final.

Nome do campo	Tipo de dados	Descrição
`ModuleID`	`win:UInt64`	ID exclusiva para o módulo.
`AssemblyID`	`win:UInt64`	ID do assembly em que esse módulo reside.
`ModuleFlags`	`win:UInt32`	0x1: módulo de domínio neutro. 0x2: o módulo tem uma imagem nativa. 0x4: módulo dinâmico. 0x8: módulo de manifesto.
`Reserved1`	`win:UInt32`	Campo reservado.
`ModuleILPath`	`win:UnicodeString`	O caminho da imagem CIL (Common Intermediate Language) para o módulo ou o nome de módulo dinâmico se ele for um assembly dinâmico (terminado em nulo).
`ModuleNativePath`	`win:UnicodeString`	Caminho da imagem nativa do módulo, se presente (terminado em nulo).
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CLR ou do CoreCLR.
`ManagedPdbSignature`	`win:GUID`	Assinatura GUID do banco de dados de programa (PDB) gerenciado que corresponde a esse módulo.
`ManagedPdbAge`	`win:UInt32`	Número de idade escrito para o PDB gerenciado que corresponde a esse módulo.
`ManagedPdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB gerenciado que corresponde a esse módulo foi criado. Em alguns casos, isso pode ser apenas um nome de arquivo.
`NativePdbSignature`	`win:GUID`	Assinatura GUID do gerador de imagem nativa (NGen) PDB que corresponde a esse módulo, se aplicável.
`NativePdbAge`	`win:UInt32`	Número de idade escrito para o PDB do NGen que corresponde a esse módulo, se aplicável.
`NativePdbBuildPath`	`win:UnicodeString`	Caminho para o local em que o PDB do NGen que corresponde a esse módulo foi criado, se aplicável. Em alguns casos, isso pode ser apenas um nome de arquivo.

AssemblyLoad_V1 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`AssemblyLoad_V1`	154	Gerado quando um assembly é carregado.

Nome do campo	Tipo de dados	Descrição
`AssemblyID`	`win:UInt64`	ID exclusiva para o assembly.
`AppDomainID`	`win:UInt64`	ID do domínio desse assembly.
`BindingID`	`win:UInt64`	ID que identifica exclusivamente a associação do assembly.
`AssemblyFlags`	`win:UInt32`	0x1: assembly de domínio neutro. 0x2: assembly dinâmico. 0x4: o assembly tem uma imagem nativa. 0x8: assembly de coleção.
`AssemblyName`	`win:UnicodeString`	O nome totalmente qualificado do assembly.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

AssemblyUnload_V1 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`FireAssemblyUnload_V1`	155	Gerado quando um assembly é carregado.

Nome do campo	Tipo de dados	Descrição
`AssemblyID`	`win:UInt64`	ID exclusiva para o assembly.
`AppDomainID`	`win:UInt64`	ID do domínio desse assembly.
`BindingID`	`win:UInt64`	ID que identifica exclusivamente a associação do assembly.
`AssemblyFlags`	`win:UInt32`	0x1: assembly de domínio neutro. 0x2: assembly dinâmico. 0x4: o assembly tem uma imagem nativa. 0x8: assembly de coleção.
`AssemblyName`	`win:UnicodeString`	O nome totalmente qualificado do assembly.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

AssemblyDCStart_V1 event

Palavra-chave para acionar o evento	Evento	Nível
`LoaderKeyword` (0x8)	`DomainModuleLoad_V1`	Informativo (4)

Evento	ID do evento	Descrição
`AssemblyDCStart_V1`	155	Enumera assemblies durante um encerramento inicial.

Nome do campo	Tipo de dados	Descrição
`AssemblyID`	`win:UInt64`	ID exclusiva para o assembly.
`AppDomainID`	`win:UInt64`	ID do domínio desse assembly.
`BindingID`	`win:UInt64`	ID que identifica exclusivamente a associação do assembly.
`AssemblyFlags`	`win:UInt32`	0x1: assembly de domínio neutro. 0x2: assembly dinâmico. 0x4: o assembly tem uma imagem nativa. 0x8: assembly de coleção.
`AssemblyName`	`win:UnicodeString`	O nome totalmente qualificado do assembly.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

AssemblyLoadStart event

Palavra-chave para acionar o evento	Evento	Nível
`Binder` (0x4)	`AssemblyLoadStart`	Informativo (4)

Evento	ID do evento	Descrição
`AssemblyLoadStart`	290	Um carregamento de assembly foi solicitado.

Nome do campo	Tipo de dados	Descrição
`AssemblyName`	`win:UnicodeString`	Nome do assembly.
`AssemblyPath`	`win:UnicodeString`	Caminho do nome do assembly.
`RequestingAssembly`	`win:UnicodeString`	Nome do assembly de solicitação ("pai").
`AssemblyLoadContext`	`win:UnicodeString`	Contexto de carregamento do assembly.
`RequestingAssemblyLoadContext`	`win:UnicodeString`	Contexto de carregamento do assembly de solicitação ("pai").
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

Evento AssemblyLoadStop

Palavra-chave para acionar o evento	Evento	Nível
`Binder` (0x4)	`AssemblyLoadStart`	Informativo (4)

Evento	ID do evento	Descrição
`AssemblyLoadStart`	291	Um carregamento de assembly foi solicitado.

Nome do campo	Tipo de dados	Descrição
`AssemblyName`	`win:UnicodeString`	Nome do assembly.
`AssemblyPath`	`win:UnicodeString`	Caminho do nome do assembly.
`RequestingAssembly`	`win:UnicodeString`	Nome do assembly de solicitação ("pai").
`AssemblyLoadContext`	`win:UnicodeString`	Contexto de carregamento do assembly.
`RequestingAssemblyLoadContext`	`win:UnicodeString`	Contexto de carregamento do assembly de solicitação ("pai").
`Success`	`win:Boolean`	Se o carregamento do assembly foi bem-sucedido.
`ResultAssemblyName`	`win:UnicodeString`	O nome do assembly que foi carregado.
`ResultAssemblyPath`	`win:UnicodeString`	O caminho do assembly do qual foi carregado.
`Cached`	`win:UnicodeString`	Se o carregamento foi armazenado em cache.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

Evento ResolutionAttempted

Palavra-chave para acionar o evento	Nível
`Binder` (0x4)	Informativo (4)

Evento	ID do evento	Descrição
`ResolutionAttempted`	292	Um carregamento de assembly foi solicitado.

Nome do campo	Tipo de dados	Descrição
`AssemblyName`	`win:UnicodeString`	Nome do assembly.
`Stage`	`win:UInt16`	O estágio de resolução. 0: Localizar noa carregamento. 1: Contexto de carregamento do assembly 2: Assemblies do aplicativo. 3: Fallback padrão do contexto de carregamento do assembly. 4: Resolver o assembly satélite. 5: Resolução de contexto de carregamento do assembly. 6: Resolução do assembly AppDomain.
`AssemblyLoadContext`	`win:UnicodeString`	Contexto de carregamento do assembly.
`Result`	`win:UInt16`	O resultado da tentativa de resolução. 0: Êxito 1: Assembly Não Encontrado 2: Versão incompatível 3: Nome do assembly incompatível 4: Falha 5: Exceção
`ResultAssemblyName`	`win:UnicodeString`	O nome do assembly que foi resolvido.
`ResultAssemblyPath`	`win:UnicodeString`	O caminho do assembly do qual foi resolvido.
`ErrorMessage`	`win:UnicodeString`	Mensagem de erro, se houver alguma exceção.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

Evento AssemblyLoadContextResolvingHandlerInvoked

Palavra-chave para acionar o evento	Nível
`Binder` (0x4)	Informativo (4)

Evento	ID do evento	Descrição
`AssemblyLoadContextResolvingHandlerInvoked`	293	Um manipulador AssemblyLoadContext.Resolving foi invocado.

Nome do campo	Tipo de dados	Descrição
`AssemblyName`	`win:UnicodeString`	Nome do assembly.
`HandlerName`	`win:UnicodeString`	Nome do manipulador invocado.
`AssemblyLoadContext`	`win:UnicodeString`	Contexto de carregamento do assembly.
`ResultAssemblyName`	`win:UnicodeString`	O nome do assembly que foi resolvido.
`ResultAssemblyPath`	`win:UnicodeString`	O caminho do assembly do qual foi resolvido.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

Evento AppDomainAssemblyResolveHandlerInvoked

Palavra-chave para acionar o evento	Nível
`Binder` (0x4)	Informativo (4)

Evento	ID do evento	Descrição
`AppDomainAssemblyResolveHandlerInvoked`	294	Um manipulador AppDomain.AssemblyResolve foi invocado.

Nome do campo	Tipo de dados	Descrição
`AssemblyName`	`win:UnicodeString`	Nome do assembly.
`HandlerName`	`win:UnicodeString`	Nome do manipulador invocado.
`ResultAssemblyName`	`win:UnicodeString`	O nome do assembly que foi resolvido.
`ResultAssemblyPath`	`win:UnicodeString`	O caminho do assembly do qual foi resolvido.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

Evento AssemblyLoadFromResolveHandlerInvoked

Palavra-chave para acionar o evento	Nível
`Binder` (0x4)	Informativo (4)

Evento	ID do evento	Descrição
`AssemblyLoadFromResolveHandlerInvoked`	295	Um manipulador Assembly.LoadFrom foi invocado.

Nome do campo	Tipo de dados	Descrição
`AssemblyName`	`win:UnicodeString`	Nome do assembly.
`IsTrackedLoad`	`win:Boolean`	Se o carregamento do assembly é rastreado.
`RequestingAssemblyPath`	`win:UnicodeString`	O caminho do assembly solicitante.
`ComputedRequestedAssemblyPath`	`win:UnicodeString`	O caminho do assembly que foi solicitado.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.

Evento KnownPathProbed

Palavra-chave para acionar o evento	Nível
`Binder` (0x4)	Informativo (4)

Evento	ID do evento	Descrição
`KnownPathProbed`	296	Um caminho conhecido foi investigado para um assembly.

Nome do campo	Tipo de Dados	Descrição
`FilePath`	`win:UnicodeString`	Caminho investigado.
`Source`	`win:UInt16`	Origem do caminho investigado. 0x0:Assemblies do aplicativo. 0x1:Caminho da imagem nativa do aplicativo. 0x2:Caminho do aplicativo. 0x3:Raízes de recursos da plataforma. 0x4:Subdiretório satélite.
`Result`	`win:UInt32`	HRESULT para a investigação.
`ClrInstanceID`	`win:UInt16`	ID exclusiva da instância do CoreCLR.