Eventos de runtime do carregador e associador do .NET

  • Artigo

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.