VSPerfCLREnv

A ferramenta de VSPerfCLREnv é usada para definir as variáveis de ambiente que são necessários para analisar um aplicativo. NET Framework.Use a seguinte sintaxe:

VsPerfCLREnv [/option]

A opção escolhido depende de qual dos três tipos de analisar usa: amostragem (, ou global.Uma opção separada é necessária para incluir dados da interação da camada nos dados de perfil.A sintaxe de cada opção é descrita nas tabelas a seguir.

Observação
Quando você analisar for, execute VSPerfCLREnv concluídas com /off ou a opção de /globaloff excluir as variáveis de ambiente necessários para analisar.Opções de Para obter mais informações, consulte VSPerfCLREnv excluir as configurações de ambiente mostradas aqui.

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

Cuidado
Analisar de interação de camada pode ser coletado usando Visual Studio Ultimate, Visual Studio Premium, ou Visual Studio Professional.Porém, os dados de perfil da interação da camada podem ser exibidos somente em Visual Studio Ultimate e em Visual Studio Premium.

Analisar de interação da camada fornece informações adicionais sobre consultas do ADO.NET em aplicativos várias estratificados.Os dados são coletados somente para chamadas de função síncronas.Os dados da interação podem ser adicionados a ser executado usando qualquer método analisando.

As opções de InteractionOn e de GlobalInteractionOn habilitam a coleção de dados de interação da camada.A opção de interação deve ser definida depois de definir a variável de ambiente de VSPerfCLREnv que é necessário analisar um aplicativo.

O exemplo a seguir inclui dados de interação da camada em analisar executado usando o método de amostragem:

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

O exemplo a seguir inclui dados de interação da camada em analisar executado 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 analisar a instrumentação do processo

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

Opção	Descrição
TraceOn	Permite analisar usando o método de gerenciamento.Não permite a alocação de memória que analisa ou que coleta dados de tempo de vida do objeto.
TraceGC	Permite a alocação de memória que analisa usando o método de gerenciamento.Não permite coletar dados de tempo de vida do objeto.
TraceGCLife	Permite a alocação de memória que analisa e que coleta dados de tempo de vida do objeto usando o método de gerenciamento.

Opções de VSPerfCLREnv para analisar de uma amostra do processo

A tabela a seguir descreve as opções de amostragem VSPerfCLREnv para analisar:

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

Opções de VSPerfCLREnv para analisar global

Para analisar um serviço como e um aplicativo Web ASP.NET gerenciadas do que é iniciado pelo sistema operacional em vez de ser iniciado pelo usuário, use opções para analisar global das opções de VSPerfCLREnv.A tabela a seguir descreve as versões globais de opções de VSPerfCLREnv.Essas opções definem as variáveis de ambiente apropriadas no Registro.

Opção	Descrição
GlobalTraceOn	Permite analisar global usando o método de gerenciamento.Não coleta eventos de alocação de memória nem objetos dados de tempo de vida.
GlobalTraceGC	Permite a alocação de memória global que analisa usando o método de gerenciamento.Não permite coletar dados de tempo de vida do objeto.
GlobalTraceGCLife	Permite a alocação de memória global que analisa usando o método de gerenciamento.Também habilita a coleção de dados de tempo de vida do objeto.
GlobalSampleOn	Permite analisar global usando o método de amostragem.Não permite coletar eventos de alocação de memória nem objetos dados de tempo de vida.
GlobalSampleGC	Permite a alocação de memória global que analisa usando o método de amostragem.Não permite coletar dados de tempo de vida do objeto.
GlobalSampleGCLife	Permite a alocação de memória global que analisa usando o método de amostragem.Também permite coletar dados de tempo de vida do objeto.

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

Quando você terminar que analisa o aplicativo gerenciado, use uma das seguintes opções excluir as variáveis de ambiente que foram adicionados por VSPerfCLREnv.A tabela a seguir descreve como excluir variáveis de ambiente padrão e globais:

Opção	Descrição
Off	Excluir variáveis de ambiente para analisar padrão do .NET.Use essa opção quando as opções não globais de VSPerfClrEnv foram usadas definir as variáveis de ambiente do profiler.
GlobalOff	Excluir variáveis de ambiente para analisar global .NET.Use essa opção quando o aplicativo foi iniciado pelo sistema operacional e não no profiler.

Comentários

Essas opções não são necessárias analisando um aplicativo gerenciado se o aplicativo é iniciado pelo desempenho Explorer no IDE.O desempenho Explorer define todas as configurações necessárias de ambiente para você.

Se o ambiente correto não foi definido durante a análise, um aviso será relatado durante a análise e os nomes de funções gerenciadas não serão resolvidos corretamente.

Consulte também

Conceitos

Usando as ferramentas de criação de perfil a partir da linha de comando