VSPerfCLREnv

A ferramenta de VSPerfCLREnv é usada para definir as variáveis de ambiente são necessárias para o perfil de um.NET Visual Basic. Ela usa a sintaxe a seguir:

VsPerfCLREnv [/option]

A opção que você escolher depende de qual dos três tipos de perfil que você usa: amostragem, instrumentação, ou globais. Uma opção separada é necessário para incluir dados de interação em camadas nos dados de criação de perfil. A sintaxe para cada opção é descrita nas tabelas a seguir.

Observação
Quando tiver terminado de criar o perfil, execute VSPerfCLREnv com o /off ou /globaloff opção para excluir as variáveis de ambiente necessárias para a criação de perfil. Para obter mais informações, consulte Opções de VSPerfCLREnv para excluir configurações de ambiente mostrado aqui.

Opções de VSPerfCLREnv para incluir dados de interação de camada

Nível de interação com o perfil fornece informações adicionais sobre o ADO.NET consultas em várias camadas de aplicativos. Dados são coletados somente para chamadas de função síncrona. Dados de interação podem ser adicionados a qualquer execução de profiling usando qualquer método de criação de perfil.

O InteractionOn e GlobalInteractionOn opções permitem que a coleção de dados de interação de camada. A opção de interação deve ser definida depois de definir a variável de ambiente VSPerfCLREnv que é necessário para criar o perfil de um aplicativo.

O exemplo a seguir inclui os dados de interação em camadas em uma execução de criação de perfil que usa o método de amostragem:

VSPerfCLREnv /SampleOn
VSPerfCLREnv /InteractionOn
VSPerfCmd /Start:Sample /Output:MyApp.exe.vsp /Launch:MyApp.exe

O exemplo a seguir inclui os dados de interação em camadas em uma execução de profiling para um serviço do Windows:

VSPerfCLREnv /GlobalSampleOn
VSPerfCLREnv /GlobalInteractionOn
REM Restart the computer and start the service
VSPerfCmd /Start:Sample /Output:MyService.exe.vsp 
VSPerfCmd /Attach:MyService.exe

Opções de VSPerfCLREnv para a criação de perfil de instrumentação do processo

A tabela a seguir descreve as opções de VSPerfCLREnv para a criação de perfil de instrumentação:

Opção	Descrição
TraceOn	Permite a criação de perfil usando o método de instrumentação. Não permitem a alocação de memória, criação de perfil ou coleta de dados de tempo de vida do objeto.
TraceGC	Permite que o perfil de alocação de memória usando o método de instrumentação. Não permite coletar dados de tempo de vida do objeto.
TraceGCLife	Permite a alocação de memória profiling e a coleta de dados de tempo de vida do objeto usando o método de instrumentação.

Opções de VSPerfCLREnv para a criação de perfil de amostragem do processo

A tabela a seguir descreve as opções de VSPerfCLREnv para a criação de perfil de amostragem:

Opção	Descrição
SampleOn	Permite a criação de perfil usando o método de amostragem. Não permitem a alocação de memória, criação de perfil ou coleta de dados de tempo de vida do objeto.
SampleGC	Permite que o perfil de alocação de memória usando o método de amostragem. Não permite coletar dados de tempo de vida do objeto.
SampleGCLife	Permite que o perfil de alocação de memória usando o método de amostragem. Também permite coletar dados de tempo de vida do objeto.
SampleLineOff	Desativa a coleção de.NET dados de criação de perfil de nível de linha.

Opções de VSPerfCLREnv para a criação de perfil Global

Para criar o perfil de um serviço gerenciado, como e ASP.Aplicativo web NET iniciado pelo sistema operacional em vez de serem iniciados pelo usuário, use as opções para criação de perfil global das opções VSPerfCLREnv. A tabela a seguir descreve as versões globais das opções de VSPerfCLREnv. Essas opções definidas as variáveis de ambiente apropriado no registro.

Opção	Descrição
GlobalTraceOn	Permite a criação de perfil global usando o método de instrumentação. Não coletar dados de tempo de vida do objeto ou de eventos de alocação de memória.
GlobalTraceGC	Permite que o perfil de alocação de memória global usando o método de instrumentação. Não permite coletar dados de tempo de vida do objeto.
GlobalTraceGCLife	Permite que o perfil de alocação de memória global usando o método de instrumentação. Também permite a coleta de dados de tempo de vida do objeto.
GlobalSampleOn	Permite a criação de perfil global usando o método de amostragem. Não permite coletar eventos de alocação de memória ou dados de tempo de vida do objeto.
GlobalSampleGC	Permite que o perfil de alocação de memória global usando o método de amostragem. Não permite coletar dados de tempo de vida do objeto.
GlobalSampleGCLife	Permite que o perfil de alocação de memória global usando o método de amostragem. Também permite coletar dados de tempo de vida do objeto.

Opções de VSPerfCLREnv para excluir as configurações de ambiente

Quando tiver terminado de perfilação do aplicativo gerenciado, você deve use uma das seguintes opções para excluir as variáveis de ambiente que foram adicionadas por VSPerfCLREnv. A tabela a seguir descreve como excluir a ambas as variáveis de ambiente padrão e globais:

Opção	Descrição
Off	Exclui as variáveis de ambiente padrão.NET de criação de perfil. Use esta opção quando as opções de VSPerfClrEnv-globais foram usadas para definir o profiler variáveis de ambiente.
GlobalOff	Exclui as variáveis de ambiente para global.NET de criação de perfil. Use esta opção quando o aplicativo foi iniciado pelo sistema operacional e não o profiler.

Comentários

Essas opções não são necessárias para criar o perfil de um aplicativo gerenciado se o aplicativo é iniciado usando o Performance Explorer no IDE. Performance Explorer define todas as configurações de ambiente necessárias para você.

Se o ambiente correto não foi definido durante a perfilação, um aviso é relatado durante a análise e a função gerenciada que nomes não serão corretamente resolvidos.

Consulte também

Conceitos

Usando as ferramentas de criação de perfil na linha de comando