Escolha a pasta de instrumentação

Se precisar reunir dados de cobertura de código ao testar o código em um binário, Visual Studio primeiro instrumentar ou binário.O processo de instrumentação adiciona código para o binário que gera dados de cobertura de código.Para obter mais informações sobre como instrumentar binários para cobertura de código, consulte Como: Obter dados de cobertura de código.

Você tem algum controle sobre o processo de instrumentação, especificamente onde instrumentação é executada.Visual Studio pode instrumentar binários de duas maneiras:

  • No local.Se você optar por no local instrumentação, Visual Studio instrumenta o binário na pasta onde o binário está antes de executar o teste. Se o binário faz parte de um aplicativo que você está criando, esta é a pasta em que Visual Studio criado o binário.

  • Na pasta de implantação.Se você não escolher instrumentação in-loco, Visual Studio instrumenta o binário no pasta de implantação.Pastas de implantação são criadas especificamente para execuções de teste.Para obter mais informações sobre o processo de implantação, consulte Visão geral do teste implantação.

Para decidir qual pasta para usar, consulte Determinar a pasta de instrumentação.Em seguida, para obter informações sobre como definir a pasta, consulte Especificar a pasta de instrumentação.

Determinar a pasta de instrumentação

Como determinar a pasta melhor instrumentar o binário?Escolhendo entre em vigor e na pasta de implantação depende do nível de acesso ao binário e o tipo do binário.

Binários com disponibilidade limitada.Qualquer binário em um ou mais dos seguintes estados é chamado na tabela a seguir de um binário com disponibilidade limitada:

  • O binário é compartilhado entre várias pessoas.O problema com binários compartilhados é a possibilidade de conflito por causa do uso simultâneo por vários usuários.Um exemplo seria se dois usuários iniciar execuções de teste e também solicitam dados de cobertura de código do mesmo binário ao mesmo time.

  • O binário está em um compartilhamento de rede, não no computador local.

  • Você tem acesso somente leitura para o binário.

Binários com um local fixo de carga.O mecanismo de execução de teste pode carregar determinados binários apenas de um local específico.sistema autônomo um binário é chamado na tabela a seguir sistema autônomo um binário com um fixo carregar local.Isso inclui os seguintes tipos de arquivos:

  • Componentes COM

  • Páginas de painel de controle

A tabela a seguir fornece orientações para escolher a pasta correta de instrumentação.Consulte o Observações adicionais coluna para casos que têm especiais fatores a considerar.

Carregar local do binário

Disponibilidade binária

instrumentar nesta pasta

Observações adicionais

Fixo

não se limitando

no local

(Nenhum)

não corrigido

limitado

na pasta de implantação

(Nenhum)

não corrigido

não se limitando

Ambas as pastas funcionam, mas é recomendável que você escolher 'na pasta de implantação'.

Se, depois de escolher instrumentação in-loco, recrie um binário instrumentado durante o execução de teste, o mecanismo de teste detecta que o binário re-built é mais recente, não restaura a versão pre-instrumented e gera um aviso de nível de execução.

Fixo

limitado

no lugar, mas ver observações adicionais

Se você não escolher instrumentação in-loco, qualquer binário em um local fixo não é instrumentado.Isso significa que, apesar de execução do teste for bem-sucedida e sem qualquer aviso de nível de execução é gerado, dados de cobertura de código não são coletados.

Para obter sugestões para solucionar esse problema, consulte Local fixo, Limited Availability binários.

Especificar a pasta de instrumentação

Você pode escolher entre instrumentação in-loco e na pasta de implantação de duas maneiras:

  • Para fazer sua escolha a configuração padrão, vá para o Opções caixa de diálogo sobre o Ferramentas menu of Visual Studio. Para localizar essa configuração, procure no Execução de teste página sob o Ferramentas de teste nó.

  • Você também pode especificar a pasta de instrumentação para uma determinada configuração de execução de teste.Sobre o Cobertura de código página no teste de executar o editor de configuração, você pode verificar Assemblies de instrumentar no local.Para obter mais informações, consulte Como: Especifique uma configuração de execução de teste.

Local fixo, Limited Availability binários

O mecanismo de teste deve ser capaz de modificar o binário que deve ser instrumentado no local.Para que isso seja possível, revise os seguintes critérios:

  • O arquivo binário não deve ter o atributo somente leitura definido.Você pode corrigir essa configuração se tiver permissões suficientes no arquivo.

  • O mecanismo de teste deve ter permissões para instrumentar o arquivo binário.Isso significa que o usuário que executa o teste deve ter os privilégios necessários para modificar os binários.Como a instrumentação é realizada pelo aplicativo host, a conta que precisa esses privilégios é a conta sob a qual devenv.exe ou MSTest.exe está sendo executada, independentemente de execução local ou remota.Esta conta pertence à pessoa que está executando o Visual Studio que executou o comando MSTest.exe ou que iniciou uma compilação que, por sua vez, está executando testes.

  • O arquivo binário não deve estar em uso ou bloqueado por outro programa.Para corrigir isso, você deve encerrar o programa de bloqueio ou aguarde até que ela seja concluída.

Se o mecanismo de teste ainda não pode instrumentar binários de um ou mais, ele gera um aviso de nível de execução.

Consulte também

Tarefas

Como: Especifique uma configuração de execução de teste

Como: configurar implementação de teste

Conceitos

Instrumentação e Re-Signing Assemblies

Visão geral do teste implantação

Outros recursos

Configurar cobertura de código