Compartilhar via


Livre de registro inicialização do Profiler e anexar

Começando com o .NET Framework versão 4, você pode anexar os geradores de perfis em tempo de inicialização do aplicativo (carga de inicialização) e aplicativos em execução (load anexar). Ambas as opções fornecem a capacidade de iniciar o geradores de perfis que não foram registrados como componentes COM.

Esses dois métodos usam protocolos diferentes para iniciar os geradores de perfis e são discutidos nas seções a seguir.

Geradores de perfis de carga de inicialização

Um gerador de perfil de carga de inicialização é carregado quando o aplicativo a ser perfilado inicia. Antes de .NET Framework 4, carregamento de inicialização foi a única maneira de carregar um profiler. O profiler tinha de ser registrado e foi localizado nos valores de variáveis de ambiente do seguinte:

  • COR_ENABLE_PROFILING = 1

  • COR_PROFILER = {CLSID do profiler}

O common language runtime (CLR) usado o CLSID do COR_PROFILER para localizar o profiler na HKEY_CLASSES_ROOT do registro.

Começando com o .NET Framework 4, você pode continuar a registrar seu gerador de perfil; No entanto, a outra variável de ambiente é marcado antes de pesquisa de registro:

  • COR_PROFILER_PATH =caminho completo do profiler DLL

Se COR_PROFILER_PATH estiver presente, seu valor é usado para localizar o profiler e pesquisa de registro será ignorada.

Observações:

  • COR_PROFILER_PATH é opcional. Se você não especificar COR_PROFILER_PATH, o CLSID do profiler é usado para encontrar seu caminho no registro.

  • Se você especifica COR_PROFILER_PATH e registrar seu gerador de perfil, o COR_PROFILER_PATH terá precedência. Se COR_PROFILER_PATH aponta para um caminho inválido, o profiler não carrega o mesmo se ele está registrado.

  • COR_PROFILER é sempre necessário. Se você especificar COR_PROFILER_PATH, a pesquisa de registro é ignorada; No entanto, o CLSID do COR_PROFILER ainda é necessário para o CreateInstance chamada.

Geradores de perfis de carga anexar

Começando com o .NET Framework 4, você pode anexar um gerador de perfil para um aplicativo em execução. Para obter mais informações sobre essa funcionalidade, consulte Profiler anexar e desanexar. Um gerador de perfil de carga de anexar usa a wszProfilerPath parâmetro da ICLRProfiling::AttachProfiler método para encontrar o local do profiler arquivo DLL. Se wszProfilerPath é nulo, o runtime tenta localizar o profiler procurando no registro o CLSID especificado na pClsidProfiler parâmetro.

Consulte também

Conceitos

Visão geral de criação de perfil

Outros recursos

A criação de perfil (referência de API não gerenciada)

Referência de API não gerenciada