VSPerfCLREnv

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

VsPerfCLREnv [/option]

A opção que você escolher depende de qual os três tipos de perfil usa: amostragem, instrumentação, ou global.Uma opção separada é necessária para incluir dados de interação na camada de dados.A sintaxe para cada opção é descrita nas tabelas.

Observação
Quando você estiver analisando execução, VSPerfCLREnv concluídas com /off ou a opção de /globaloff excluir as variáveis de ambiente necessários para analisar.Para obter mais informações, consulte as opções de 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.No entanto, a interação de camada que analisa dados pode ser exibida somente em Visual Studio Ultimate e em Visual Studio Premium.

Analisar de interação de camada fornece informações sobre consultas adicionais do ADO.NET em aplicativos com camadas múltiplas.Os dados são coletados somente para chamadas de função síncronos.Os dados de interação podem ser adicionados a analisar executado usando qualquer método para.

As opções de InteractionOn e de GlobalInteractionOn permitem a coleção de dados de interação de camada.A opção de interação deve ser definida após definir a variável de ambiente de VSPerfCLREnv necessário para analisar um aplicativo.

O exemplo a seguir inclui dados de interação camada de análise 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 camada de análise 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 de instrumentação:

Opção	Descrição
TraceOn	Permite analisar usando o método de instrumentação.Não permite a alocação de memória que analisa ou que coleta dados da vida útil de objeto.
TraceGC	Permite que a alocação de memória para traçar perfil usando o método de instrumentação.Não permite coletar dados da vida útil de objeto.
TraceGCLife	Permite que a alocação de memória para traçar perfil e que coleta dados da vida útil de objeto usando o método de instrumentação.

Opções de VSPerfCLREnv para analisar de preparação de exemplos de processo

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

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 da vida útil de objeto.
SampleGC	Permite que a alocação de memória para traçar perfil usando o método de amostragem.Não permite coletar dados da vida útil de objeto.
SampleGCLife	Permite que a alocação de memória para traçar perfil usando o método de amostragem.Também permite coletar dados da vida útil de objeto.
SampleLineOff	Desativa a coleção de linhas nível .NET que analisa dados.

Opções de VSPerfCLREnv para analisar global

Para analisar um serviço como um aplicativo da web e gerenciados do ASP.NET que é iniciada 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 instrumentação.Não coleção eventos de alocação de memória nem objetos de dados tempo de vida.
GlobalTraceGC	Permite que a alocação de memória global traçar perfil usando o método de instrumentação.Não permite coletar dados da vida útil de objeto.
GlobalTraceGCLife	Permite que a alocação de memória global traçar perfil usando o método de instrumentação.Também permite a coleção de dados da vida útil de objeto.
GlobalSampleOn	Permite analisar global usando o método de amostragem.Não permite coletar eventos de alocação de memória nem objetos de dados tempo de vida.
GlobalSampleGC	Permite que a alocação de memória global traçar perfil usando o método de amostragem.Não permite coletar dados da vida útil de objeto.
GlobalSampleGCLife	Permite que a alocação de memória global traçar perfil usando o método de amostragem.Também permite coletar dados da vida útil de objeto.

Opções de VSPerfCLREnv exclua as configurações de ambiente

Quando você terminar de 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	Exclui variáveis de ambiente para analisar padrão do .NET.Use esta opção quando as opções de VSPerfClrEnv globais não foram usadas definir as variáveis de ambiente profiler.
GlobalOff	Exclui variáveis de ambiente para analisar global .NET.Use esta opção quando o aplicativo for iniciado pelo sistema operacional e não pelo profiler.

Comentários

Essas opções não são necessárias para um aplicativo gerenciado se o aplicativo é iniciado usando o 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 erro é relatado durante a análise e nomes de função gerenciados não serão resolvidos corretamente.

Consulte também

Conceitos

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