Opções da Linha de Comando MSTest.exe

Artigo
08/04/2011

MSTest.exe é o comando de linha de comando que é usado para executar testes. Esse comando terá várias opções que você pode usar para personalizar sua execução do teste. Você pode usar muitas dessas opções em conjunto com um do outro. Na verdade, você deve usar determinadas opções em conjunto com outras opções, conforme descrito nas seções a seguir. Você pode especificar essas opções em qualquer ordem na linha de comando MSTest.exe.

MSTest. exe não interpretará as opções ou os valores especificados para eles de uma maneira de diferenciar maiúsculas de minúsculas.

As tabelas a seguir listam todas as opções para MSTest.exe e breves descrições destas. Você pode ver um resumo semelhante digitando MSTest /h na linha de comando.

Opções Gerais de Linha de Comando

/testcontainer:[nome do arquivo]	Carregar um arquivo que contém testes. Exemplo: /testcontainer:tests.dll Para obter mais informações, consulte /testcontainer.
/testmetadata:[nome do arquivo]	Carrega um arquivo que contém metadados de testes. Para obter mais informações, consulte /testmetadata.
/testlist:[caminho da lista de teste]	Especifica a lista de testes, conforme especificado no arquivo de metadados, a ser executada. Para obter mais informações, consulte /testlist.
/category:[filtro de categorias de teste]	Especifique e filtrar quais categorias de teste para executar. Para obter mais informações, consulte /category.
/test:[nome de teste]	Especifica o nome de um teste a ser executado. Para obter mais informações, consulte /teste.
/noisolation	Execute testes dentro do processo do MSTest. exe. Esta opção melhora a velocidade de execução de teste, mas aumenta o risco para o processo do MSTest. exe.
/testsettings: [nome do arquivo]	Use o arquivo de configurações de teste especificada. Exemplo: /testsettings:Local.Testsettings Para obter mais informações, consulte /testsettings.
/runconfig:[nome do arquivo]	Usa o arquivo de configuração de execução especificado. Exemplo: /runconfig:localtestrun.Testrunconfig Para obter mais informações, consulte /runconfig. Observação Esta opção de linha de comando é mantida para compatibilidade com versões anteriores do Microsoft Visual Studio 2010.Configurações de execução de teste foram substituídas pelas configurações de teste no Visual Studio 2010 Ultimate.
/resultsfile:[nome do arquivo]	Salva os resultados da execução do teste para o arquivo especificado. Exemplo: /resultsfile:testResults.trx Para obter mais informações, consulte /resultsfile.
/unique	Execute o teste somente se for encontrada uma correspondência exclusiva para qualquer especificado /test. Para obter mais informações, consulte /unique.
/detail:[identificação de propriedade]	Especifica o nome de uma propriedade, cujos valores se deseje mostrar, caso existam, juntamente com o resultado de teste. Para obter mais informações, consulte /detail.
/help	Exibir a mensagem de uso do MSTest. exe (forma abreviada: /?or /h).
/nologo	Não exibe nenhuma faixa inicialização nem mensagem de direitos autorais.
/usestderr	Use o erro padrão para as informações de erro de saída.

Opções de Linha de Comando para Publicação dos Resultados de Testes

Para obter mais informações sobre essas opções, consulte Opções de Linha de Comando para Publicação dos Resultados de Testes.

/publish:[nome do servidor]	Publica os resultados do banco de dados para a coleção de projeto de equipe do servidor especificado.
/publishresultsfile:[nome do arquivo]	Especifica o nome do arquivo de resultados a ser publicado. Se nenhum nome de arquivo de resultados for especificado, usa o arquivo produzido pela execução atual.
/publishbuild:[Criar id]	Publica resultados de teste usando a identificação desta compilação.
/teamproject:[nome do projeto de equipe]	Especifica o nome do projeto da equipe ao qual pertence a compilação.
/platform:[plataforma]	Especifica a plataforma da compilação na qual devem ser publicados os resultados do teste.
/flavor:[flavor]	Especifica o tipo da compilação na qual devem ser publicados resultados do teste.

Usando Opções MSTest

As seções a seguir descrevem muitas das opções para MSTest.exe com mais detalhes. As opções que foram usadas para publicação de resultados de teste não estão incluídas aqui. Para obter informações sobre essas opções, consulte Opções de Linha de Comando para Publicação dos Resultados de Testes.

/testcontainer

/testcontainer:[nome do arquivo]

O contêiner de teste é um arquivo que contém os testes que você deseja executar. Por exemplo, para testes ordenados, o contêiner de teste é o arquivo .orderedtest que define o teste ordenado. Para testes de unidade, ele é o assembly compilado a partir o projeto do teste que contém os arquivos de origem do teste de unidade.

Observação
Para testes de unidade, este é o assembly que contém o código de teste não o assembly que contém o código do aplicativo que você está testando. Por exemplo, se sua solução contiver um projeto denominado BankAccount e um projeto de teste chamado BankAccountTest, especificar /testcontainer:BankAccountTest.dll.

Observação
Porque o arquivo de metadados de teste também lista os testes que você pode executar, você não deve especificar ambas as /testcontainer e /testmetadata Opções em uma única linha de comando. Fazer isso poderia gerar ambiguidade e produzir um erro.

/testmetadata

/testmetadata:[nome do arquivo]

Você pode usar o /testmetadata opção para executar testes em vários contêiners de teste.

O arquivo de metadados de teste é criado para sua solução quando você cria listas de teste usando a janela do Editor de lista de teste. Este arquivo contém informações sobre todos os testes listados na janela Editor de lista de teste. Esses são todos os testes que existem em todos os projetos de testes em sua solução.

O arquivo de metadados do teste é um arquivo XML que é criado na pasta da solução. Este arquivo é mostrado no Solution Explorer sob o nó Solution Items. Um arquivo de metadados de teste tem a extensão. vsmdi e está associado à janela do Editor de lista de teste. Ou seja, se clicar duas vezes em um arquivo. vsmdi no Windows Explorer, o arquivo abre Visual Studio e seu conteúdo. Todos os testes em projetos de teste da solução são exibidos na janela do Editor de lista de teste.

Você pode alterar o arquivo de metadados de teste somente fazendo alterações são refletidas na janela do Editor de lista de teste, como, por exemplo, criar ou excluir testes ou alterar propriedades de um teste.

Observação
Como o contêiner de teste contém testes que você pode executar, você não deve especificar ambas as /testcontainer e /testmetadata Opções em uma única linha de comando. Fazer isso poderia gerar ambiguidade e produzir um erro.

Quando você usa o /testmetadata opção, é recomendável que você indique testes específicos para executar usando o /test opção ou o /testlist opção ou ambos.

/testlist

/testlist:[caminho da lista de teste]

O /testlist opção é uma lista de testes, conforme especificado no arquivo de metadados de teste, para estar em execução. Para executar os testes que estão contidos em várias listas de teste, use o /testlist opção várias vezes. Quaisquer testes ordenados na lista de teste serão executados.

Observação
Você pode usar o /testlist opção somente se você usar também o /testmetadata opção.

Você pode usar o /testlist opção e o /test opção junto. Isso equivale a selecionar uma lista de teste e um ou mais testes individuais na janela Editor de lista de teste e, em seguida, clicando em Executar testes.

/category

/category:[filtro de categorias de teste]

Use o /category opção para especificar qual categoria de teste para executar.

Observação
Você deve usar o /testcontainer a opção para usar o /category opção.

Você só pode usar o /category opção uma vez por linha de comando, mas você pode especificar várias categorias de teste com o filtro de categoria de teste. O filtro de categorias de teste consiste em um ou mais nomes de categoria de teste separados por operadores lógicos '&', ' | ','!', '&!'. Os operadores lógicos '&' e ' |' não podem ser usados juntos para criar um filtro de categoria de teste.

Por exemplo:

/category:group1executa testes na categoria de teste "grupo1".
**/category:"group1&group2"**executa testes em ambas as categorias do teste "grupo1" e "grupo2". Os testes que estão apenas em uma das categorias de teste especificado não serão executados.
**/category:"group1|group2"**executa testes que estão na categoria de teste "grupo1" ou "grupo2". Testes de ambas as categorias de teste também serão executados.

**/category:"group1&!group2"**executa testes na categoria de teste "grupo1" que não estão na categoria de teste "grupo2". Um teste que está em ambas as categorias de teste "grupo1" e "grupo2" não será executado.

Observação
Se o seu filtro consiste em uma única categoria, como /category:group1, não é necessário colocar o filtro entre aspas. No entanto, se o seu filtro faz referência a mais de uma categoria, como /category:"group1&group2" , em seguida, o filtro deve ser colocado entre aspas.

/Test

/test:[nome de teste]

Use o /test opção para especificar testes individuais para executar. Para executar vários testes, utilize o /test opção várias vezes.

Observação
Você pode usar o /test opção com um a /testcontainer opção ou com o /testmetadata opção, mas não com ambos.

A seqüência de caracteres que você especificar com a /test opção é usada para corresponder aos nomes de testes em um contêiner de teste ou um arquivo de metadados de teste. Isso significa que você pode especificar vários testes, utilizando um único valor para /test. Por exemplo, especificando /test:ittest deve produzir correspondências para testes denominados DebitTest e CreditTest porque os dois nomes de teste contém a subseqüência de caracteres 'ittest'.

Observação
O valor que você especificar com a /test opção é testada não apenas o nome do teste, mas também o caminho desse teste, como visto no Solution Explorer, ou, com testes de unidade, para o seu nome totalmente qualificado.

Segue dois exemplos de uso:

Exemplo de teste de unidade: O arquivo UnitTest1. cs no projeto TestProject2 contém uma unidade de teste chamada TestMethod1. Especificando um valor de 'ittest' para o /test opção também corresponderiam este teste, porque a seqüência de caracteres é verificada com o nome totalmente qualificado "TestProject2.UnitTest1.TestMethod1" e a seqüência de caracteres 'ittest' também aparece em 'unittest1'.

Exemplo de teste genérico: A seguinte linha de comando executa o teste genérico especificado e, nos resultados do teste, exibe o caminho completo do teste.

mstest /testcontainer:"C:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\TestProject2\TestProject2\generictest1.generic" /test:testproject32\generic

/noisolation

/noisolation

Use esta opção para executar testes dentro do processo do MSTest. exe. Usando essa opção faz com que nenhuma outra alteração para a configuração de execução de teste. O objetivo dessa opção é melhorar a velocidade de execução de teste. No entanto, ela aumenta o risco para a execução como um todo, porque uma exceção não tratada lançada pelo código de teste faria com que o processo do MSTest. exe falha do teste.

/testsettings

/testsettings:[nome do arquivo]

Use esta opção para especificar um arquivo de configurações de teste. Por exemplo: /testsettings:local.Testsettings

Você pode especificar um arquivo de configurações de teste de outras maneiras, como com a opção /testmetadata. As regras que governam a especificação de testar as configurações de arquivos são descritos aqui.

Se você usar o /testsettings opção, o arquivo que ele especifica serão usados, se você usar também o /testmetadata opção.
Se você usar o /testmetadata opção para apontar para um arquivo de metadados que especifica o arquivo de configurações do teste ativo, que testa o arquivo de configurações será usada se você não usar o /testsettings opção.
Se você não usar o /testsettings opção e você também não especifica um arquivo de configurações de teste no arquivo de metadados do teste, a execução de teste usa o arquivo de configurações do padrão de teste.

Observação

Para obter mais informações sobre arquivos de configurações de teste, consulte Criar configurações de teste para testes automatizados, como parte de um plano de teste.

Observação
Para obter mais informações sobre arquivos de configurações de teste, consulte Criar configurações de teste para testes automatizados, como parte de um plano de teste.

/runconfig

/runconfig:[nome do arquivo]

Notaesta opção de linha de comando é mantida para compatibilidade com versões anteriores do Microsoft Visual Studio 2010. Configurações de execução de teste foram substituídas pelas configurações de teste no Visual Studio 2010 Ultimate.

Use esta opção para especificar um arquivo de configuração de execução. Por exemplo: /runconfig:localtestrun.Testrunconfig

Você pode especificar um arquivo de configuração de execução de outras maneiras, como com a opção /testmetadata. As regras que governam a especificação de arquivos de configuração de execução são descritos aqui.

Se você usar o /runconfig opção, o arquivo que ele especifica serão usados, quer você use ou não o /testmetadata opção.
Se você usar o /testmetadata opção para apontar para um arquivo de metadados que especifica o arquivo de configuração de execução ativa, que execute o arquivo de configuração será usada se você não usar o /runconfig opção.
Se você não usar o /runconfig opção e você também não especifica um arquivo de configuração de execução no arquivo de metadados do teste, a execução de teste usa o padrão, execute o arquivo de configuração.

/resultsfile

/resultsfile:[nome do arquivo]

Use esta opção para salvar os resultados do teste executação para o arquivo nomeado. Por exemplo: /resultsfile.

/unique

/unique

Use o /unique opção em conjunto com o /test opção. O /unique opção instrui MSTest. exe para executar um teste somente se houver uma correspondência exclusiva para o valor fornecido com o /test opção.

Por exemplo, o contêiner de teste MyTestProject contém testes denominados MethodTest1 e MethodTest10.

A linha de comando:

mstest /testcontainer:testproject2.dll /test:MethodTest1

executa ambos os testes, MethodTest1 e MethodTest10, pois 'MethodTest1' é uma subsequência de caracteres de 'MethodTest10'.

Mas a linha de comando:

mstest /testcontainer:testproject2.dll /test:MethodTest1 /unique

Retorna um erro que não há uma correspondência exclusiva para esse nome de teste. Você pode identificar exclusivamente o nome de teste usando a identificação para o teste que é listado no modo de exibição de propriedades para o teste.

/usestderr

/usestderr

Usar esta opção fará com que as seguintes informações para serem gravados no erro padrão:

Testes com um resultado de falha, anulado, erro, expirou, não executável ou não executado.
Erros de nível de execução.
Erros na análise os argumentos de linha de comando.
Resumo será executado quando a execução de teste possui um resultado de falha.

Sem essa opção, toda a saída é enviada para a saída padrão.

/detail

/detail:[identificação de propriedade]

Esta opção é usada para exibir propriedades adicionais de casos de teste, se existirem. Você pode passar mais de uma instância de /detail opção, cada uma com apenas uma identificação de propriedade, em única linha de comando. Do propriedade válida id para o /detail opção a seguir:

adapter	id	projectrelativepath
computername	isautomated	readonly
debugtrace	link	spoolmessage
description	longtext	stderr
displaytext	name	stdout
duration	outcometext	storage
errormessage	owner	testcategoryid
errorstacktrace	parentexecid	testname
executionid	priority	testtype
groups	projectname	traceinfo

Observação
A seleção real da propriedade IDs que pode ser usado com a opção /detail varia de acordo com o tipo de teste. Portanto, esta lista é somente uma aproximação. Em particular, se você estiver usando os tipos de teste personalizada, a seleção de propriedades será diferente. Para saber quais identificadores de propriedades você pode usar, examine o arquivo de resultados de teste produzido pela execução de teste. Para obter mais informações sobre o teste de arquivos de resultados, consulte Como: Salvar e abrir os resultados de teste em Visual Studio.

A seleção real da propriedade IDs que pode ser usado com a opção /detail varia de acordo com o tipo de teste. Portanto, esta lista é somente uma aproximação. Em particular, se você estiver usando os tipos de teste personalizada, a seleção de propriedades será diferente. Para saber quais identificadores de propriedades você pode usar, examine o arquivo de resultados de teste produzido pela execução de teste. Para obter mais informações sobre o teste de arquivos de resultados, consulte Como: Salvar e abrir os resultados de teste em Visual Studio.

Se uma propriedade existir para um caso de teste especificado, suas informações será incluído resumo de resultado de saída.

Por exemplo, a linha de comando:

mstest /testcontainer:Errors.dll /detail:testtype

produz a saída a seguir, que contém informações do tipo de teste:

...
Results                    Top Level Tests
--------                   -----------------
Inconclusive               TestProject2.BankAccountTest.CreditTest
[testtype] = Unit Test
...

Consulte também

Conceitos

Revisar os resultados do teste

Execução automatizada de testes a partir da linha de comando

Compartilhar via